UTF8Len
Die Funktion gibt die Anzahl der Zeichen einer UTF-8-Zeichenfolge zurück.
Wenn die Zeichenfolge nicht mit dem UTF-8-Format übereinstimmt, gibt die Funktion den Wert 0 zurück.
Zusätzlich prüft die Funktion, ob alle Zeichen gültige ASCII-Zeichen sind und gibt dies über den Ausgang bASCII
aus.
Die Funktion stoppt die Überprüfung nach Tc2_Utilities.Parameterlist.cMaxCharacters
. Bei entsprechender Parametrierung kann so eine Endlosschleife vermieden werden.
FUNCTION UTF8Len : UDINT
Der Rückgabewert liefert die Anzahl der Zeichen in der UTF-8-Zeichenfolge.
VAR_INPUT
VAR_INPUT
pUTF8 : PVOID;
END_VAR
pUTF8: Zeiger auf die null-terminierte UTF-8-Zeichenfolge
VAR_OUTPUT
VAR_OUTPUT
bASCII : BOOL;
nSize : UDINT;
END_VAR
bASCII: TRUE, wenn die UTF-8-Zeichen gültige ASCII-Zeichen sind.
nSize: Größe der Zeichenfolge in Bytes (ohne Null-Terminierung). Die Größe in Bytes kann je nach Zeichen größer sein als die Länge der Zeichenfolge.
Dokumentation zum Attribut 'TcEncoding' := 'UTF-8' Für weitere Informationen zu Zeichenfolgen im UTF-8 Format siehe auch die Dokumentation zum Attribut ‚TcEncoding‘. |
Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS-Bibliotheken (Kategoriegruppe) |
---|---|---|
TwinCAT v3.1.4022 | PC oder CX (x86, x64, ARM) | Tc2_Utilities (System) >= 3.3.21.0 |