STRNCPY

Die Funktion kopiert die Zeichenfolge einer Variablen vom Datentyp STRING 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 STRNCPY : BOOL

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

Name	Typ	Beschreibung
pDst	POINTER TO STRING	Zeiger auf die kopierte STRING-Variable (Eingabe-Zeichenfolge)
pSrc	POINTER TO STRING	Zeiger auf die zu kopierende STRING-Variable (Ausgabe-Zeichenfolge)
nDstSize	UDINT	Größe der resultierenden STRING-Variablen (Ausgabe-Zeichenfolge) in Bytes, bei der Zuweisung kann der Operator SIZEOF() verwendet werden.

VAR_OUTPUT
    nSrcLen  : UDINT;
    nDstLen  : UDINT;
END_VAR

Name	Typ	Beschreibung
nSrcLen	UDINT	Länge der angegebenen zu kopierenden STRING-Variablen
nDstLen	UDINT	Länge der kopierten WSTRING-Variablen

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