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
VAR_INPUT
VAR_INPUT
pDstWSTRING : POINTER TO WSTRING;
pSrcSTRING : POINTER TO STRING;
nDstSize : UDINT;
END_VAR
pDstWSTRING: Zeiger auf die konvertierte WSTRING-Variable (Ausgabe-Zeichenfolge)
pSrcSTRING: Zeiger auf die zu konvertierende STRING-Variable (Eingabe-Zeichenfolge)
nDstSize: 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 |