Tipuri de date

Tipuri scalare#

Fiecare valoare dintr-un script are un tip concret. Numele de tipuri de mai jos se folosesc în declarațiile cu tip (consultați Variabile locale), iar proprietatea .Type le returnează.

Int32 x := 4; eșuează cu Unknown variable or constant 'Int32'. Nume precum Int32 și UInt32 există doar printre tipurile de date Modbus ale funcțiilor MODBUSR și MODBUSW.

Tipuri structurate#

Tipurile structurate conțin mai multe valori, disponibile ca proprietăți:

Tipuri de enumerare#

Un tip de enumerare este un set fix de valori cu nume, pe care unele funcții le primesc ca parametru:

O valoare de enumerare se scrie simplu (Utc) sau cu tipul ei (DateTimeKind.Utc). Tipurile de enumerare funcționează și drept cuvinte cheie de declarare:

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

Colecții#

collection<T> este o listă de valori cu un singur tip de element T.

collection<uint16> registers := UINT16COLLECTION(4);
collection<string> names := {"a", "b", "c"};
collection<uint8> data := BYTECOLLECTION("0A0B0C");
LENGTH(names);
# Result: 3

• Tipul elementului provine din declarație, altfel din primul element care nu este Null. {Null} singur eșuează cu Unable to determine collection type.
• Colecțiile imbricate nu sunt acceptate: Collection<Collection<>> is not supported.
• Colecțiile sunt valori de tip referință. APPEND, INSERT, REMOVEAT, SETAT și REPLACE modifică colecția pe loc și returnează aceeași colecție.
• BYTECOLLECTION, UINT16COLLECTION și BOOLCOLLECTION creează cel mult 2048 de elemente; fiecare formă semnalează un număr mai mare cu propriul mesaj (consultați Erori la rulare).
• LENGTH(c) sau c.Length returnează numărul de elemente.

Disponibilitate — colecțiile cu tip din Core 2022.2; UINT16COLLECTION și BOOLCOLLECTION din Core 2026.1, build 39001.

Proprietatea .Type#

Fiecare valoare are proprietatea numai în citire .Type, care returnează numele tipului ei ca text. Pentru o valoare de enumerare este tipul de enumerare, de exemplu "DateTimeKind".

VAR x := 5.5;
x.Type;
# Result: "Double"
VAR c := BYTECOLLECTION("0A0B");
c.Type;
# Result: "Collection<UInt8>"

Proprietățile se pot citi doar dintr-o variabilă cu nume. AVG('a', 'c').Type eșuează cu Unexpected character '.'; valoarea se stochează mai întâi într-o variabilă.

Reguli de conversie a tipurilor#

În aritmetică, prima regulă care se potrivește celor doi operanzi decide tipul rezultatului:

1. Oricare operand este double (sau o valoare de grup): double.
2. Oricare operand este float: float.
3. Oricare operand este int64: int64.
4. Oricare operand este uint64: uint64.
5. Oricare operand este uint: uint când și celălalt este fără semn, altfel int64.
6. În rest (întregi mai mici, bool, char): int.

Împărțirea a doi întregi trunchiază rezultatul. Un literal numeric este de tip double, deci împărțirea la el nu trunchiază:

int a := 5;
int b := 2;
a / b;
# Result: 2
a / 2;
# Result: 2.5

• Operatorii pe biți lucrează cu întregi; un operand double se convertește mai întâi în int64.
• + cu un șir de caractere pe oricare parte concatenează textul: "T=" + 21.5 este "T=21.5".
• datetime + număr adaugă milisecunde, datetime + timespan adaugă intervalul, iar timespan ± timespan funcționează conform așteptărilor.
• Împărțirea la zero oprește scriptul cu Division by zero. Împărțitorul se protejează cu IF.
• Atribuirea către o variabilă cu tip convertește valoarea în tipul ei, consultați Variabile locale.

Null și NaN#

NaN este un număr a cărui valoare este necunoscută, de exemplu un senzor care încă nu a fost citit sau un dispozitiv în eroare. Null înseamnă că nu există deloc o valoare: un dispozitiv șters sau o funcție care nu a găsit nimic.

• Compararea cu literalul NaN (x = NaN, x < NaN) este respinsă la parsarea scriptului: Comparison with NaN is always false. Use the IsNaN method to check for NaN value. Se folosește ISNAN.
• <, >, <= și >= cu un operand Null dau FALSE. Null = Null, Null <= Null și Null >= Null sunt TRUE, Null = 5 este FALSE.
• &, | și ^ cu un operand Null dau Null; << și >> dau Null pentru o valoare Null în stânga, în timp ce un număr de deplasări Null oprește scriptul cu Cannot cast DataType.Null to number.
• Aritmetica și logica cu Null (Null + 5, !Null) opresc scriptul cu Operator '+' not defined for 'Null' and 'Double'. Valoarea se verifică mai întâi cu ISNULL.
• O condiție Null a lui IF contează ca FALSE.
• MIN, MAX, AVG și ORDER omit Null și NaN; variantele …STRICT le transmit mai departe. EQUALS(NaN, NaN) este TRUE.

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