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.
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.
VAR_OUTPUT
VAR_OUTPUT
nSrcLen : UDINT;
nDstLen : UDINT;
END_VAR
nSrcLen: Length of the specified WSTRING variable to be copied
nDstLen: Length of the copied WSTRING variable
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 |