WSTRNCPY
The function copies the string of a variable of the data type WSTRING and checks whether the string was completely copied.
The function returns
- TRUE if it was possible to copy the complete character string (content of the source array).
- FALSE if the character string was truncated when copying. If the input string is longer than the output string, only the number of characters (including null termination) corresponding to the length of the output string will be copied.
The function stops after Parameterlist.cMaxCharacters characters in order to avoid an infinite loop.
FUNCTION WSTRNCPY : BOOL
VAR_INPUT
VAR_INPUT
pDst : POINTER TO WSTRING;
pSrc : POINTER TO WSTRING;
nDstSize : UDINT;
END_VAR
pDst: Pointer to the copied WSTRING variable (input string)
pSrc: Pointer to the WSTRING variable to be copied (output string)
nDstSize: Size of the resulting WSTRING variable (output string) in bytes. The operator SIZEOF() can be used for the assignment.
Requirements
Development environment | Target platform | PLC libraries to be integrated (category group) |
|---|---|---|
TwinCAT v3.1.4022 | PC or CX (x86, x64, ARM) | Tc2_Utilities (System) >= 3.3.21.0 |