---
title: "Logika a diagnostika"
description: "Logika a diagnostika ve skriptu TapHome: test Null a NaN, zápis 0 při chybě zařízení, porovnání desetinných čísel pomocí EQUALS, hlášení chyb zařízení pomocí ADDERROR, filtrování zákmitů."
url: "https://taphome.com/cs/docs/script/logic-and-diagnostics/"
language: cs
lastmod: 2026-10-13
generator: hugo
ai:
  topics: ["scripting-language","nan-handling","null-handling","device-errors","diagnostics"]
  questions: ["Jak ve skriptu TapHome ověřit, zda je hodnota Null nebo NaN?","Jak zapsat hodnotu 0, když je zařízení v chybě nebo místo čísla vrací NaN?","Jak porovnat dvě desetinná čísla s tolerancí?","Jak na zařízení Modbus nebo Packet parser zobrazit vlastní chybu nebo varování?","Proč ADDERROR selže s hlášením „function not supported here“?","Mohu ve smart rule použít SLEEP?","Co dělá DEBOUNCE ve skriptu zařízení?"]
---

# Logika a diagnostika

Funkce skriptu TapHome pro neznámé hodnoty a diagnostiku zařízení: ISNULL, ISNAN, EQUALS, SLEEP, ADDERROR, ADDWARNING, ADDINFO a DEBOUNCE.

Poslední aktualizace: 2026-10-13

Tyto funkce testují hodnoty na `Null` a `NaN`, porovnávají desetinná čísla s tolerancí, pozastavují skript zařízení a hlásí zprávy na zařízení. `NaN` je neznámé číslo, `Null` je chybějící hodnota — viz [Datové typy](https://taphome.com/cs/docs/script/data-types/). Minimální verze Core pro každou funkci je uvedena v [Požadavcích na verzi](https://taphome.com/cs/docs/script/version-requirements/).

## ISNULL

`ISNULL` vrátí `TRUE`, když je hodnota `Null`, tedy chybějící hodnota — například `LastState` při prvním běhu smart rule Vzorec nebo `PARSEJSON` s ignorováním chyb, když cesta nebyla nalezena.

```text
ISNULL(value)
```

**Vrací** — `bool`. Přijme hodnotu libovolného typu. `NaN` je číslo, ne chybějící hodnota, takže `ISNULL(NaN)` je `FALSE`.

**Příklad**

```taphome
IF(ISNULL(LastState), 0, LastState);
# Result: 0 on the first run of a Formula smart rule, then the previous result
```

**Viz také** — [ISNAN](https://taphome.com/cs/docs/script/logic-and-diagnostics/#isnan), [Skripty ve smart rules](https://taphome.com/cs/docs/script/smart-rules/).

## ISNAN

`ISNAN` vrátí `TRUE`, když je číslo `NaN`, tedy neznámá hodnota — například hodnota zařízení, které je v chybě nebo ještě nebylo přečteno.

```text
ISNAN(number)
```

**Vrací** — `bool`.

**Poznámky** — `NaN` se nikdy ničemu nerovná. Porovnání s literálem `NaN`, například `x = NaN`, je odmítnuto už při uložení skriptu. Argument musí být číslo: `ISNAN(Null)` zastaví skript chybou za běhu, proto když může hodnota i chybět, testujte nejprve `ISNULL`.

**Příklad — zápis 0, když je zařízení v chybě nebo vrací NaN**

Pomocí `IF(ISNAN(x), 0, x)` předáte číslo dál, i když je zdrojové zařízení v chybě:

```taphome
IF(ISNAN(x), 0, x);
# Result: 0 while the device is in error or returns NaN, otherwise x
```

Když může být hodnota i `Null`, ověřte to nejprve — `OR` nevyhodnotí pravou stranu, když je levá už `TRUE`:

```taphome
IF(ISNULL(value) OR ISNAN(value), 0, value);
```

**Chyby** — *Comparison with NaN is always false. Use the IsNaN method to check for NaN value.* (při uložení skriptu).

**Viz také** — [ISNULL](https://taphome.com/cs/docs/script/logic-and-diagnostics/#isnull), [EQUALS](https://taphome.com/cs/docs/script/logic-and-diagnostics/#equals).

## EQUALS

`EQUALS` vrátí `TRUE`, když se dvě čísla liší nejvýše o toleranci (`epsilon`, výchozí 0.005); použijte ho místo `=` u desetinných hodnot, jako jsou teploty.

```text
EQUALS(number1, number2)
EQUALS(number1, number2, epsilon)
```

**Parametry**

| Název | Typ | Popis |
|---|---|---|
| `number1`, `number2` | number | Porovnávané hodnoty. |
| `epsilon` | number, nepovinný | Největší rozdíl, který se ještě počítá jako shoda. Výchozí `0.005`. |

**Vrací** — `bool`. Dvě hodnoty `NaN` se považují za shodné, takže `EQUALS(NaN, NaN)` je `TRUE`. Argument `Null` je chyba za běhu.

**Příklad**

```taphome
# rozdíl je ve výchozí toleranci 0.005
EQUALS(21.499, 21.5);
# Result: TRUE
# rozdíl 0.1 je nad zadanou tolerancí 0.01
EQUALS(21.4, 21.5, 0.01);
# Result: FALSE
# dvě hodnoty NaN se považují za stejné
EQUALS(NaN, NaN);
# Result: TRUE
```

## SLEEP

`SLEEP` pozastaví skript Modbus nebo Packet parser na zadaný počet milisekund (0 – 10 000) a toto číslo vrátí.

```text
SLEEP(milliseconds)
```

**Poznámky** — Zatímco skript čeká, modul nedotazuje svá zařízení, proto pauzu držte krátkou, typicky jako mezeru, kterou zařízení potřebuje mezi dvěma zápisy.

**Příklad**

```taphome
MODBUSW(H, 100, Uint16, 1);
SLEEP(200);
MODBUSW(H, 101, Uint16, 1);
```

**Chyby**

- *SLEEP function not allowed in this context.* — skript patří ke smart rule (Rovnice, Vzorec nebo Skript) nebo k oznámení; nelze ho uložit.
- *Interval 'X' is out of range (0-10000)* — za běhu.

**Dostupnost** — skripty Modbus a Packet parser.

## ADDERROR, ADDWARNING, ADDINFO

`ADDERROR`, `ADDWARNING` a `ADDINFO` zobrazí na zařízení v aplikaci TapHome chybu, varování nebo informační zprávu a vrátí `TRUE`.

```text
ADDERROR(text)
ADDERROR(code, text)
ADDWARNING(text)
ADDWARNING(code, text)
ADDINFO(text)
ADDINFO(code, text)
```

**Parametry**

| Název | Typ | Popis |
|---|---|---|
| `code` | celé číslo, nepovinný | Identifikuje zprávu. Zprávy s různými kódy se zobrazují vedle sebe; nová zpráva se stejným kódem nebo druhá zpráva bez kódu nahradí tu předchozí. |
| `text` | string | Zpráva zobrazená v aplikaci. |

**Poznámky** — Zprávy se vyhodnocují při každém běhu: zpráva zmizí, jakmile ji běh skriptu přestane vyvolávat.

**Příklad**

```taphome
VAR alarm := MODBUSR(H, 599, Uint16);
IF(alarm > 0, ADDERROR("There are " + alarm + " active alarms"));
IF(GETBIT(MODBUSR(H, 600, Uint16), 0) = 1, ADDERROR(1, "Alarm 1 active"));
IF(GETBIT(MODBUSR(H, 600, Uint16), 1) = 1, ADDWARNING(2, "Filter change due"));
```

**Chyby** — *ADDERROR function not supported here.* (nebo `ADDWARNING`, `ADDINFO`) v jakémkoli skriptu, který není uveden v části Dostupnost.

**Dostupnost** — skripty pro čtení modulů a zařízení Modbus; skripty pro čtení, zápis a listener skripty modulu Packet parser. **Ne** ve skriptech Modbus pro zápis a inicializaci, v servisních atributech a servisních akcích obou integrací, ve smart rules ani v oznámeních.

**Viz také** — [Funkce Modbus](https://taphome.com/cs/docs/script/modbus/), [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/).

## DEBOUNCE

`DEBOUNCE` po zadaný počet milisekund ignoruje hodnoty, které se pro jednu hodnotu zařízení přečtou ze zařízení, a po uplynutí této doby hodnotu zkontroluje znovu; zápisů do zařízení se netýká.

```text
DEBOUNCE(deviceVariable, milliseconds)
```

**Parametry**

| Název | Typ | Popis |
|---|---|---|
| `deviceVariable` | proměnná zařízení | Zkratka hodnoty zařízení, například `St`. Výraz není přijat. |
| `milliseconds` | number | Délka okna, 0 nebo více. |

**Vrací** — interval. U hodnoty zařízení bez filtru zákmitů volání nic neudělá.

**Příklad**

```taphome
DEBOUNCE(St, 500);
```

**Chyby**

- *DEBOUNCE - Function is not available* — skript není skriptem zařízení uvedeným v části Dostupnost.
- *DEBOUNCE - invalid argument, must be a device variable*

**Dostupnost** — TapHome Next 2026.1.36599+ · skripty Modbus pro čtení a zápis zařízení, skripty Packet parser pro čtení a zápis a listener skripty.
