UTF8_TO_WSTRING

Die Funktion konvertiert eine Zeichenfolge im UTF-8-Format in eine Zeichenfolge (Variable) vom Datentyp WSTRING.

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. Die Eingabe-Zeichenfolge ist zu lang, um auf die Ausgabe-Zeichenfolge codiert zu werden. Der Speicherbedarf der Ausgabe-Zeichenfolge kann bei Konvertierung zu UTF-8 höher sein als der der Eingabe-Zeichenfolge. Unbekannte Zeichen werden übersprungen.

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

FUNTION UTF8_TO_WSTRING : BOOL

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

VAR_INPUT

VAR_INPUT
    pDstWSTRING : POINTER TO WSTRING;
    pSrcUTF8    : PVOID;
    nDstSize    : UDINT;
END_VAR

pDstWSTRING: Zeiger auf die konvertierte WSTRING-Variable (Ausgabe-Zeichenfolge)

pSrcUTF8: Pointervariable (Eingabe-Zeichenfolge)

nDstSize: Größe der resultierenden WSTRING-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