• Home
• Function/Function Block Reference
• IEC 61131-3 Functions and Function Blocks
• Character String
• DELETE

DELETE

Type	Function
Description	Deletes a substring from a given string. L characters of the input string at IN are deleted, beginning at character position P.
Notes	P cannot be 0. The first position in a string is 1. Do not use the same string as input and output string because the string might shrink in a loop.
Parameters	Inputs IN Data type: STRING Description: Input string. L Data type: ANY_INT Description: Number of characters to be deleted. P Data type: ANY_INT Description: Position of the first character to be deleted. Output OUT Data type: STRING Description: Output string.
Error behavior	Error behavior The following table shows the errors which may occur while executing the function and the value returned by the function in the corresponding error case. Error case Output value L < 0 Empty string '' P <= 0 Empty string '' P + L > len(IN) + 1 (len(...) = actual string length) Empty string '' Resulted string too short Empty string '' If the listed error occurs, a string error is written to the Online log in the MESSAGES window. Note Controller stop on string error: The controller can be automatically stopped when a string error occurs. This allows you to locate the error in your project. To enable the automatic stop of the controller in case of a string error, activate the button in the Cockpit toolbar of the controller.
Additional information	EN/ENO behavior The POU is only executed if TRUE is applied to the EN input. If EN = FALSE, the POU is not executed and ENO = FALSE indicates the inactivity. If any of the errors listed under "Error behavior" occurs while executing the function, ENO is set to FALSE. Further Info See the topic "General information on execution control with EN/ENO" for further details.