STRING_TO_WSTRING2

Die Funktion konvertiert eine Variable vom Datentyp STRING in eine Variable vom Datentyp WSTRING und prüft, ob die Eingabe-Zeichenfolge länger als die Ausgabe-Zeichenfolge ist. In diesem Fall wird die Zeichenfolge abgeschnitten.

Die Funktion liefert

TRUE, wenn die Konvertierung der kompletten Zeichenfolge erfolgreich war.
FALSE, wenn die Eingabe-Zeichenfolge länger als die Ausgabe-Zeichenfolge ist und das Ergebnis nicht in den gegebenen Ausgangspuffer passt. Der Speicherbedarf der Ausgabe-Zeichenfolge ist höher als der der Eingabe-Zeichenfolge. Die Zeichenfolge wird dann abgeschnitten.

Die Funktion stoppt die Konvertierung nach Parameterlist.cMaxCharacters Zeichen, um eine Endlosschleife zu vermeiden.

FUNCTION STRING_TO_WSTRING2 : BOOL

Eingänge

VAR_INPUT
    pDstWSTRING : POINTER TO WSTRING;
    pSrcSTRING  : POINTER TO STRING;
    nDstSize    : UDINT;
END_VAR

Name	Typ	Beschreibung
pDstWSTRING	POINTER TO WSTRING	Zeiger auf die konvertierte WSTRING-Variable (Ausgabe-Zeichenfolge)
pSrcSTRING	POINTER TO STRING	Zeiger auf die zu konvertierende STRING-Variable (Eingabe-Zeichenfolge)
nDstSize	UDINT	Größe der resultierenden WSTRING-Variablen (Ausgabe-Zeichenfolge) in Bytes. bei der Zuweisung kann der Operator SIZEOF() verwendet werden.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.4022	PC oder CX (x86, x64, ARM)	Tc2_Utilities (System) >= 3.3.21.0