WSTRNCPY
Die Funktion kopiert die Zeichenfolge einer Variablen vom Datentyp WSTRING und prüft, ob die Zeichenfolge vollständig kopiert wurde.
Die Funktion liefert
- TRUE, wenn die Zeichenfolge (Inhalt des Quell-Arrays) vollständig kopiert werden konnte.
- FALSE, wenn die Zeichenfolge beim Kopieren abgeschnitten wurde. Wenn die Eingabe-Zeichenfolge länger als die Ausgabe-Zeichenfolge ist, wird nur die Anzahl an Zeichen (einschließlich Null-Terminierung) kopiert, die der Länge der Ausgabe-Zeichenfolge entspricht.
Rückgabewert
Name | Typ | Beschreibung |
|---|---|---|
WSTRNCPY | BOOL | Kopiert die Zeichenfolge einer Variablen vom Datentyp WSTRING und prüft, ob die Zeichenfolge vollständig kopiert wurde. |
Eingänge
VAR_INPUT
pDst : POINTER TO WSTRING;
pSrc : POINTER TO WSTRING;
nDstSize : UDINT;
END_VARName | Typ | Beschreibung |
|---|---|---|
pDst | POINTER TO WSTRING | Zeiger auf die kopierte WSTRING-Variable (Eingabe-Zeichenfolge) |
pSrc | POINTER TO WSTRING | Zeiger auf die zu kopierende WSTRING-Variable (Ausgabe-Zeichenfolge) |
nDstSize | UDINT | Größe der resultierenden WSTRING-Variablen (Ausgabe-Zeichenfolge) in Bytes. Bei der Zuweisung kann der Operator SIZEOF() verwendet werden. |
Ausgänge
VAR_OUTPUT
nSrcLen : UDINT;
nDstLen : UDINT;
END_VARName | Typ | Beschreibung |
|---|---|---|
nSrcLen | UDINT | Länge der angegebenen zu kopierenden WSTRING-Variablen |
nDstLen | UDINT | Länge der kopierten WSTRING-Variablen |
Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS-Bibliotheken (Kategoriegruppe) |
|---|---|---|
TwinCAT v3.1.4022 | PC oder CX (x86, x64, Arm®) | Tc2_Utilities (System) >= 3.3.21.0 |