Převody datových typů

Převodní funkce mění hodnoty na text a zpět: čísla a datum na naformátovaný text, text na čísla a bajty a text do Base64 nebo do tvaru bezpečného pro XML. Převod BCD (TOBCD, FROMBCD) je na stránce Bitové operace a převod barev (HSVTORGB, RGBTOHSV) na stránce Barvy.

TOSTRING#

TOSTRING převede libovolnou hodnotu na text — čísla a datum s volitelným formátovacím řetězcem .NET, kolekce bajtů a bloby s kódováním textu.

1
2
3

TOSTRING(value)
TOSTRING(value, format)
TOSTRING(bytes, encoding)

Příklad

TOSTRING(192, "X");
# Result: "C0"
TOSTRING(192, "X4");
# Result: "00C0"
TOSTRING(123.34, "F4");
# Result: "123.3400"
TOSTRING(123.34, "F0");
# Result: "123"
TOSTRING(BYTECOLLECTION("48656c6c6f"));
# Result: "Hello"
TOSTRING(BYTECOLLECTION("48656c6c6f"), "iso-8859-1");
# Result: "Hello"

V listener skriptu přečte TOSTRING(RECEIVEDMSG.PAYLOAD, "utf-8") přijatou zprávu jako text — viz RECEIVEDMSG.

Formátovací řetězce#

TOSTRING formátuje čísla a datum formátovacími řetězci .NET a vždy používá desetinnou tečku bez ohledu na jazykové nastavení řídicí jednotky.

Poznámky

• Formát, který obsahuje velké X, nejprve převede hodnotu na 32bitové celé číslo a pak ji vypíše šestnáctkově.
• Ve formátech data je HH 24hodinový čas a hh 12hodinový čas; MM je měsíc a mm minuta.

Příklad — časové razítko pro log nebo požadavek HTTP

VAR now := NOW();
"Updated " + TOSTRING(now, "dd.MM.yyyy HH:mm");

TODOUBLE#

TODOUBLE přečte číslo z textu s desetinnou tečkou a vrátí NaN, když text není číslo.

1

TODOUBLE(text)

Vrací — double. NaN, když text nelze přečíst; 0 pro Null.

Poznámky — Text se vždy čte s desetinnou tečkou. Čárka se bere jako oddělovač tisíců, takže "1,5" dá 15. Když zdroj používá desetinnou čárku, nejprve ji nahraďte.

Příklad

TODOUBLE("232");
# Result: 232
TODOUBLE("-192.332");
# Result: -192.332
TODOUBLE("some text");
# Result: NaN
TODOUBLE(REPLACE("21,5", ",", "."));
# Result: 21.5

TOBYTES#

TOBYTES zakóduje text do kolekce bajtů (collection<uint8>) v kódování iso-8859-1, pokud nezadáte jiné.

1
2

TOBYTES(text)
TOBYTES(text, encoding)

Poznámky — Starší dokumentace tuto funkci nazývala TOBYTEARRAY; takový název jazyk nezná. Použijte TOBYTES k přípravě dat pro SENDDATA nebo pro UNPACKVALUE.

Příklad

VAR bytes := TOBYTES("Hello");
LENGTH(bytes);
# Result: 5
VAR euro := TOBYTES("€", "utf-8");
LENGTH(euro);
# Result: 3

Chyby — TOBYTES - argument 1 must be a string (text je Null); TOBYTES - unknown encoding.

ENCODE#

ENCODE escapuje text pro XML ("xml") nebo ho zakóduje do Base64 ("base64", z bajtů textu v UTF-8).

1

ENCODE(text, coding)

Poznámky

• "xml" nahradí &, ', ", > a < za &, ', ", > a <.
• Prázdný text vrátí prázdný řetězec. U názvu kódování nezáleží na velikosti písmen.
• "base64" vyžaduje Core 2022.2 nebo novější.

Příklad

ENCODE("a<b & c>d", "xml");
# Result: "a&lt;b &amp; c&gt;d"
ENCODE("user:pass", "base64");
# Result: "dXNlcjpwYXNz"

Příklad — autorizační hlavička HTTP Basic

VAR auth := "Authorization: Basic " + ENCODE("user:pass", "base64");
VAR response := SENDHTTPREQUEST("/status", "GET", "", auth);

Chyby — ENCODE Unknown encoding. Valid values are ‘xml’, ‘base64’.

DECODE#

DECODE je opakem ENCODE: převede entity XML zpět na znaky ("xml") nebo dekóduje Base64 na text v UTF-8 ("base64").

1

DECODE(text, coding)

Příklad

DECODE("dXNlcjpwYXNz", "base64");
# Result: "user:pass"
DECODE("a < b", "xml");
# Result: "a < b"
DECODE(PARSEJSON(json, "payload"), "base64");

Chyby — The provided text does not have the base64 format.; DECODE Unknown encoding. Valid values are ‘xml’, ‘base64’.

Viz také — ENCODE, PARSEJSON.