REPLACE (FUN)¶

FUNCTION REPLACE : STRING(255)

Replaces a specific number of characters of a string by another string

REPLACE(STR1, STR2, L, P) means: Replace L characters from STR1 by STR2, beginning with the character in the P position.

POS = 0 or POS = 1, are both addressing the first character.

Note

The current implementation is unfortunately not correct for the case P=0. The implementation cannot be changed for compatibility reasons.
If P=0 is used, the parameter L is internally reduced by one!
It is generally recommended to use values in the range specified by IEC 61131-3. The smallest value for P is specified there as 1.

(* Example declaration *)
VarSTRING1 : STRING ;

(* Example in ST , result is 'SKYSI' *)
VarSTRING1 := REPLACE ('SUXYSI','K',2,2);

InOut:

Scope	Name	Type	Comment
Return	`REPLACE`	`STRING(255)`	Resulting string
Input	`STR1`	`STRING(255)`	String of which a part is replaced
	`STR2`	`STRING(255)`	String which replaces a part of `STR1`
	`L`	`INT`	Number of characters, counting from left
	`P`	`INT`	Start position of the characters to be replaced. `P = 1` or `P = 0` are both addressing the first character