WSTRING_TO_UTF8

Die Funktion konvertiert eine Zeichenfolge einer Variablen vom Datentyp WSTRING in eine Zeichenfolge im UTF-8-Format.

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 als der der Eingabe-Zeichenfolge sein.) Unbekannte Zeichen werden übersprungen.

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

Rückgabewert

Name	Typ	Beschreibung
WSTRING_TO_UTF8	BOOL	Konvertiert eine Zeichenfolge einer Variablen vom Datentyp WSTRING in eine Zeichenfolge im UTF-8-Format.

Eingänge

VAR_INPUT
    pDstUTF8    : PVOID;
    pSrcWSTRING : POINTER TO WSTRING;
    nDstSize    : UDINT;
END_VAR

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

	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