UTF8_TO_STRING

Die Funktion konvertiert eine Zeichenfolge im UTF8-Format (Pointervariable vom Datentyp PVOID) in eine Zeichenfolge (Variable) vom Datentyp STRING.

Die Funktion liefert

TRUE, wenn die Konvertierung möglich war.
FALSE, wenn die Konvertierung aufgrund der gegebenen Zeichensätze nicht möglich war.

Wenn die Eingabe-Zeichenfolge länger als die Ausgabe-Zeichenfolge ist, wird die Zeichenfolge abgeschnitten. Unbekannte Zeichen werden übersprungen.

Die Funktion stoppt die Konvertierung nach Tc2_Utilities.Parameterlist.cMaxCharacters. Bei entsprechender Parametrierung kann so eine Endlosschleife vermieden werden.

FUNCTION UTF8_TO_STRING : BOOL

Der Rückgabewert ist TRUE, wenn die Konvertierung erfolgreich war.

VAR_INPUT

VAR_INPUT
    pDstSTRING : POINTER TO STRING;
    pSrcUTF8   : PVOID;
    nDstSize   : UDINT;
END_VAR

pDstSTRING: Zeiger auf die konvertierte STRING-Variable (Ausgabe-Zeichenfolge)

pSrcUTF8: Pointervariable (Eingabe-Zeichenfolge)

nDstSize: Größe der resultierenden STRING-Variablen (Ausgabe-Zeichenfolge) in Bytes. Bei der Zuweisung kann der Operator SIZEOF() verwendet werden.

VAR_OUTPUT

VAR_OUTPUT
    nDstLen        : UDINT;
END_VAR

nDstLen: Tatsächliche Länge der Ausgabe-Zeichenfolge als Anzahl von Zeichen.

	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