DELETE2
The function removes nLen characters from a string, starting at position nPos.
The function returns
- TRUE if the characters were successfully removed.
- FALSE if the resulting string is longer than the output string and doesn't fit in the given output buffer. The memory requirement for the resulting string is then larger than that for the output string. The string is then truncated.
The function stops the checking of the input length after Parameterlist.cMaxCharacters
characters in order to avoid an infinite loop.
FUNCTION DELETE2 : BOOL
Inputs
VAR_INPUT
pSrcString : POINTER TO STRING;
pDstString : POINTER TO STRING;
nDstSize : UDINT;
nLen : UDINT;
nPos : UDINT;
END_VAR
Name | Type | Description |
---|---|---|
pSrcString | POINTER TO STRING | Pointer to the STRING variable (input string) |
pDstString | POINTER TO STRING | Pointer to the resulting STRING variable (output string) |
nDstSize | UDINT | Size of the resulting STRING variable (output string) in bytes. The operator SIZEOF() can be used for the assignment. |
nLen | UDINT | Number of characters to be removed. |
nPos | UDINT | Position of the first character to be removed including the following characters (nPos = 1 = first character). |
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.35.0 |