---
title: "Dátové typy"
description: "Dátové typy skriptov TapHome: int, uint16, double, string, datetime, httpresponse, collection\u003cT\u003e, enumy, .Type, celočíselné delenie, povýšenie typov a Null oproti NaN."
url: "https://taphome.com/sk/docs/script/data-types/"
language: sk
lastmod: 2026-11-06
generator: hugo
ai:
  topics: ["scripting-language","data-types","collections","null-handling","nan"]
  questions: ["Aké dátové typy má skriptovací jazyk TapHome?","Prečo 5 / 2 dá v jednom skripte 2 a v inom 2.5?","Ako zistím typ hodnoty v skripte?","Aký je rozdiel medzi Null a NaN?","Prečo sa x = NaN neskompiluje?"]
---

# Dátové typy

Dátové typy skriptovacieho jazyka TapHome: čísla, text, štruktúrované a enum typy, kolekcie, vlastnosť .Type, povýšenie typov v aritmetike a správanie Null a NaN.

Posledná aktualizácia: 2026-11-06

Skriptovací jazyk TapHome má skalárne typy, ako sú čísla a text, štruktúrované typy, enum typy a kolekcie, a táto stránka ich vymenúva všetky. Vysvetľuje aj to, ako vlastnosť `.Type` vráti typ hodnoty, ako aritmetika určuje typ výsledku a ako sa správajú `Null` a `NaN`. Stačí vám skript, pretože tu uvedené názvy typov sa používajú v typovaných deklaráciách. Vďaka nim deklarujete typované premenné a vyhnete sa prekvapeniam, ako je celočíselné delenie, pri ktorom `5 / 2` dá 2.

## Skalárne typy

Každá hodnota v skripte nesie konkrétny typ. Názvy typov nižšie sa používajú v typovaných deklaráciách (pozrite [Lokálne premenné](https://taphome.com/sk/docs/script/variables/#local-variables)) a vracia ich vlastnosť [`.Type`](https://taphome.com/sk/docs/script/data-types/#type-property).

| Typ | Hodnoty | Poznámky |
|---|---|---|
| `bool` | `TRUE`, `FALSE` | Každé nenulové číslo sa prevedie na `TRUE`, nula na `FALSE`. |
| `int8`, `uint8`, `int16`, `uint16`, `int`, `uint`, `int64`, `uint64` | Celé čísla s 8, 16, 32 a 64 bitmi | `int` a `uint` sú 32-bitové typy. `uint8` je bajt bajtových kolekcií. |
| `float`, `double` | Čísla s pohyblivou desatinnou čiarkou | Číselné literály a väčšina aritmetiky dávajú `double`. |
| `char` | Jeden znak, `'A'` | V aritmetike vystupuje ako kód znaku. |
| `string` | Text, `"abc"` | `+` so stringom na ktorejkoľvek strane spája text. |

> [!NOTE]
> `Int32 x := 4;` skončí chybou `Unknown variable or constant 'Int32'`. Názvy ako `Int32` a `UInt32` existujú iba medzi dátovými typmi Modbus vo funkciách [`MODBUSR`](https://taphome.com/sk/docs/script/modbus/#modbusr) a [`MODBUSW`](https://taphome.com/sk/docs/script/modbus/#modbusw).

## Štruktúrované typy

Štruktúrované typy obsahujú viac hodnôt, dostupných ako vlastnosti:

| Typ | Obsahuje | Vlastnosti |
|---|---|---|
| `datetime` | Dátum a čas s druhom (`Local`, `Utc`, `Unspecified`) | Pozrite [Dátum a čas](https://taphome.com/sk/docs/script/date-and-time/) |
| `timespan` | Časový interval | `Days`, `Hours`, `Minutes`, `Seconds`, `Milliseconds`, `TotalDays`, `TotalHours`, `TotalMinutes`, `TotalSeconds`, `TotalMilliseconds` (iba na čítanie) |
| `httprequest` | Pripravená HTTP požiadavka z funkcie [`HTTPREQUEST`](https://taphome.com/sk/docs/script/packet-parser/#httprequest) | `Path`, `Method`, `Body`, `Headers` (na čítanie aj zápis) |
| `httpresponse` | Odpoveď funkcie [`SENDHTTPREQUEST`](https://taphome.com/sk/docs/script/packet-parser/#sendhttprequest) | `Content`, `Headers`, `IsSuccess`, `StatusCode`, `ReasonPhrase` (iba na čítanie) |
| `receivedmessage` | Prichádzajúca správa `RECEIVEDMSG` v listener skripte | `Protocol`, `Payload`, `Length`, `Topic`, `ContentType`, `PayloadFormat`, `ClientId`, `Expiry`, `Dup` (iba na čítanie) |
| `blob` | Surové bajty, napríklad `RECEIVEDMSG.PAYLOAD` | `Length` (iba na čítanie) |
| `rgbcolor`, `hsvcolor` | Farby, pozrite [Farby](https://taphome.com/sk/docs/script/colours/) | `Red`, `Green`, `Blue` a `Hue`, `Saturation`, `Value` (na čítanie aj zápis) |
| `groupvalue` | Hodnota skupiny zariadení | `Calculated`, `Values` (iba na čítanie) |
| `currentvalueinfo`, `historyvalues` | Časti premennej typu Info o hodnote | Pozrite [Info o hodnote](https://taphome.com/sk/docs/script/value-info/#value-info) |

## Enum typy

Enum typ je pevná množina pomenovaných hodnôt, ktorú niektoré funkcie berú ako parameter:

| Typ | Hodnoty | Používa ho |
|---|---|---|
| `ModbusRegisterType` | `C`, `H`, `D`, `A` | [Funkcie Modbus](https://taphome.com/sk/docs/script/modbus/) |
| `ModbusDataType` | `Int16`, `Uint16`, `Int32`, `UInt32`, `Float`, `Bool`, `String`, `Int64`, `UInt64`, `Double` a ich varianty poradia bajtov, pozrite [Dátové typy Modbus](https://taphome.com/sk/docs/script/modbus-data-types/) | Funkcie Modbus, [`PACKVALUE`](https://taphome.com/sk/docs/script/binary-data/#packvalue), [`UNPACKVALUE`](https://taphome.com/sk/docs/script/binary-data/#unpackvalue) |
| `LinearType` | `DEFAULT`, `BOUNDS`, `STRICT`, `INFINITE` | [`LINEAR`](https://taphome.com/sk/docs/script/interpolation-and-thresholds/#linear) |
| `DateTimeKind` | `Local`, `Utc`, `Unspecified` | [`NOW`](https://taphome.com/sk/docs/script/date-and-time/#now), [`DATETIME`](https://taphome.com/sk/docs/script/date-and-time/#datetime) |
| `DayOfWeek` | `Monday` … `Sunday` | Vlastnosti typu `datetime` |
| `CompareOptions` | `None`, `IgnoreCase`, `IgnoreNonSpace`, `IgnoreSymbols`, `IgnoreKanaType`, `IgnoreWidth`, `OrdinalIgnoreCase`, `StringSort`, `Ordinal` | [`COMPARE`](https://taphome.com/sk/docs/script/text-string-and-byte-array/#compare) |

Hodnota enumu sa píše samostatne (`Utc`) alebo s názvom svojho typu (`DateTimeKind.Utc`). Enum typy fungujú aj ako kľúčové slová deklarácie:

```taphome
DateTimeKind kind := Utc;
VAR t := NOW(kind);
```

## Kolekcie

`collection<T>` je zoznam hodnôt jedného typu prvku `T`.

```taphome
# vytvorenie typovaných kolekcií
collection<uint16> registers := UINT16COLLECTION(4);
collection<string> names := {"a", "b", "c"};
collection<uint8> data := BYTECOLLECTION("0A0B0C");
# počet prvkov
LENGTH(names);
# Result: 3
```

- Typ prvku sa preberá z deklarácie, inak z prvého prvku, ktorý nie je `Null`. Samotné `{Null}` skončí chybou `Unable to determine collection type`.
- Vnorené kolekcie nie sú podporované: `Collection<Collection<>> is not supported`.
- Kolekcie sú referenčné hodnoty. [`APPEND`](https://taphome.com/sk/docs/script/text-string-and-byte-array/#append), `INSERT`, `REMOVEAT`, `SETAT` a [`REPLACE`](https://taphome.com/sk/docs/script/text-string-and-byte-array/#replace) menia kolekciu na mieste a vracajú tú istú kolekciu.
- `BYTECOLLECTION`, `UINT16COLLECTION` a `BOOLCOLLECTION` vytvoria najviac 2048 prvkov; väčší počet hlási každý tvar vlastnou správou (pozri [Chyby pri vykonávaní](https://taphome.com/sk/docs/script/errors/#runtime-errors)).
- `LENGTH(c)` alebo `c.Length` vráti počet prvkov.

**Dostupnosť** — typované kolekcie: Core 2022.2 alebo novší; `UINT16COLLECTION` a `BOOLCOLLECTION`: TapHome Next 2026.1.39016+.

## Vlastnosť .Type

Každá hodnota má vlastnosť `.Type` iba na čítanie, ktorá vracia názov jej typu ako text. Pri hodnote enumu je to názov enum typu, napríklad `"DateTimeKind"`.

```taphome
# typ čísla
VAR x := 5.5;
x.Type;
# Result: "Double"
# typ kolekcie
VAR c := BYTECOLLECTION("0A0B");
c.Type;
# Result: "Collection<UInt8>"
```

Vlastnosti sa dajú čítať iba z pomenovanej premennej. `AVG('a', 'c').Type` skončí chybou `Unexpected character '.'`; hodnotu si najprv uložte do premennej.

## Pravidlá konverzie typov

V aritmetike o type výsledku rozhoduje prvé pravidlo, ktoré pre dva operandy platí:

1. Jeden z operandov je `double` (alebo hodnota skupiny): `double`.
2. Jeden z operandov je `float`: `float`.
3. Jeden z operandov je `int64`: `int64`.
4. Jeden z operandov je `uint64`: `uint64`.
5. Jeden z operandov je `uint`: `uint`, keď je aj druhý bez znamienka, inak `int64`.
6. Inak (menšie celé čísla, `bool`, `char`): `int`.

Delenie dvoch celých čísel desatinnú časť odrezáva. Číselný literál je `double`, takže delenie ním ju neodrezáva:

```taphome
# dve celé čísla
int a := 5;
int b := 2;
# delenie celých čísel odreže desatinnú časť
a / b;
# Result: 2
# číselný literál je double
a / 2;
# Result: 2.5
```

- Bitové operátory pracujú s celými číslami; operand typu `double` sa najprv prevedie na `int64`.
- `+` so stringom na ktorejkoľvek strane spája text: `"T=" + 21.5` je `"T=21.5"`.
- `datetime` + číslo pripočíta milisekundy, `datetime` + `timespan` pripočíta interval a `timespan` ± `timespan` funguje podľa očakávania.
- Delenie nulou zastaví skript chybou `Division by zero`. Deliteľ ošetrite pomocou [`IF`](https://taphome.com/sk/docs/script/basics/#if).
- Priradenie do typovanej premennej prevedie hodnotu na typ premennej, pozrite [Lokálne premenné](https://taphome.com/sk/docs/script/variables/#local-variables).

## Null a NaN

`NaN` je číslo, ktorého hodnota je neznáma, napríklad zo senzora, ktorý ešte nebol prečítaný, alebo zo zariadenia v chybe. `Null` znamená, že hodnota vôbec neexistuje: zmazané zariadenie alebo funkcia, ktorá nič nenašla.

- Porovnanie s literálom `NaN` (`x = NaN`, `x < NaN`) sa odmietne už pri parsovaní skriptu: `Comparison with NaN is always false. Use the IsNaN method to check for NaN value.` Použite [`ISNAN`](https://taphome.com/sk/docs/script/logic-and-diagnostics/#isnan).
- `<`, `>`, `<=` a `>=` s operandom `Null` dávajú `FALSE`. `Null = Null`, `Null <= Null` a `Null >= Null` sú `TRUE`, `Null = 5` je `FALSE`.
- `&`, `|` a `^` s operandom `Null` dávajú `Null`; `<<` a `>>` dávajú `Null` pri hodnote `Null` vľavo, kým `Null` ako počet posunu zastaví skript chybou `Cannot cast DataType.Null to number`.
- Aritmetika a logika s `Null` (`Null + 5`, `!Null`) zastaví skript chybou `Operator '+' not defined for 'Null' and 'Double'`. Hodnotu najprv skontrolujte funkciou [`ISNULL`](https://taphome.com/sk/docs/script/logic-and-diagnostics/#isnull).
- Podmienka `IF` s hodnotou `Null` sa počíta ako `FALSE`.
- `MIN`, `MAX`, `AVG` a `ORDER` preskakujú `Null` a `NaN`; varianty `…STRICT` ich prenášajú ďalej. [`EQUALS(NaN, NaN)`](https://taphome.com/sk/docs/script/logic-and-diagnostics/#equals) je `TRUE`.

```taphome
IF(ISNULL(value) OR ISNAN(value), 0, value);
# Result: the value, or 0 when it is missing or unknown
```
