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.
Rückgabewert
Name | Typ | Beschreibung |
|---|---|---|
STRNCPY | BOOL | Kopiert die Zeichenfolge einer Variablen vom Datentyp STRING und prüft, ob die Zeichenfolge vollständig kopiert wurde. |
Eingänge
VAR_INPUT
pDst : POINTER TO STRING;
pSrc : POINTER TO STRING;
nDstSize : UDINT;
END_VARName | 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. |
Ausgänge
VAR_OUTPUT
nSrcLen : UDINT;
nDstLen : UDINT;
END_VARName | Typ | Beschreibung |
|---|---|---|
nSrcLen | UDINT | Länge der angegebenen zu kopierenden STRING-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 |