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.

Eingänge

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

Name	Typ	Beschreibung
pDstWSTRING	POINTER TO WSTRING	Zeiger auf die konvertierte WSTRING-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