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.

Eingänge

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

Name	Typ	Beschreibung
pDstSTRING	POINTER TO STRING	Zeiger auf die konvertierte STRING-Variable (Ausgabe-Zeichenfolge)
pSrc UTF8	PVOID	Pointervariable (Eingabe-Zeichenfolge)
nDstSize	UDINT	Größe der resultierenden STRING-Variablen (Ausgabe-Zeichenfolge) in Bytes, bei der Zuweisung kann der Operator SIZEOF() verwendet werden.

Ausgänge

VAR_OUTPUT
    nDstLen        : UDINT;
END_VAR

Name	Typ	Beschreibung
nDstLen	UDINT	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