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.

FUNCTION WSTRNCPY : BOOL

VAR_INPUT

VAR_INPUT
    pDst     : POINTER TO WSTRING;
    pSrc     : POINTER TO WSTRING;
    nDstSize : UDINT;
END_VAR

pDst: Zeiger auf die kopierte WSTRING-Variable (Eingabe-Zeichenfolge)

pSrc: Zeiger auf die zu kopierende WSTRING-Variable (Ausgabe-Zeichenfolge)

nDstSize: Größe der resultierenden WSTRING-Variablen (Ausgabe-Zeichenfolge) in Bytes. Bei der Zuweisung kann der Operator SIZEOF() verwendet werden.

VAR_OUTPUT

VAR_OUTPUT
    nSrcLen  : UDINT;
    nDstLen  : UDINT;
END_VAR

nSrcLen: Länge der angegebenen zu kopierenden WSTRING-Variablen

nDstLen: 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