STRING_TO_UTF8

Die Funktion konvertiert eine beliebige Zeichenfolge einer Variablen vom Datentyp STRING 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 ist als die Ausgabe-Zeichenfolge, 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 der Konvertierung zu UTF-8 höher sein als der der Eingabe-Zeichenfolge.

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

FUNCTION STRING_TO_UTF8 : BOOL

Eingänge

VAR_INPUT
    pDstUTF8   : PVOID;
    pSrcSTRING : POINTER TO STRING;
    nDstSize   : UDINT;
END_VAR

Name	Typ	Beschreibung
pDstUTF8	PVOID	Zeiger auf die Zeichenfolge im UTF-8-Format (Ausgabe-Zeichenfolge)
pSrcSTRING	POINTER TO STRING	Zeiger auf die zu konvertierende STRING-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