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.

Eingänge

VAR_INPUT
    pUTF8 : PVOID;
END_VAR

Name	Typ	Beschreibung
pUTF8	PVOID	Zeiger auf die null-terminierte UTF-8-Zeichenfolge

Ausgänge

VAR_OUTPUT
    bASCII   : BOOL;
    nSize    : UDINT;
END_VAR

Name	Typ	Beschreibung
bASCII	BOOL	TRUE, wenn die UTF-8-Zeichen gültige ASCII-Zeichen sind.
nSize	UDINT	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