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.
FUNCTION WSTRING_TO_UTF8 : BOOL
VAR_INPUT
VAR_INPUT
pDstUTF8 : PVOID;
pSrcWSTRING : POINTER TO WSTRING;
nDstSize : UDINT;
END_VAR
pDstUTF8: Pointervariable (Ausgabe-Zeichenfolge)
pSrcWSTRING: Zeiger auf die WSTRING-Variable (Eingabe-Zeichenfolge)
nDstSize: 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 |