replace() function

The replace() function inserts or replaces a specific attribute, value, or subvalue in the string referenced by dyn.array.exp with the value referenced in str.exp.

Syntax

replace(dyn.array.exp, ac.exp; str.exp)
replace(dyn.array.exp, ac.exp, vc.exp; str.exp)
replace(dyn.array.exp, ac.exp, vc.exp, sc.exp, str.exp)

Parameter(s)

`dyn.array.exp`	Attribute, value, or subvalue to replace with the value in `str.exp`.
`ac.exp`	Attribute (or, the attribute that contains the value or subvalue) that contains the specified `dyn.array.exp` to replace.
`vc.exp`	Value (or, the value that contains the subvalue) that contains the specified `dyn.array.exp` to replace.
`sc.exp`	Subvalue that contains the specified `dyn.array.exp` to replace.
`str.exp`	Value to replace the value specified in `dyn.array.exp`.

Description

-1 can be specified as the ac.exp, vc.exp, or sc.exp. This appends str.exp as the last element in the respective location. If the last character of str.exp is not the correct separator, the appropriate mark character (attribute, value, or subvalue) is inserted before the expression is added.

Alternate method, using dynamic array reference symbols:

dyn.array.exp<ac.exp {,vc.exp {,sc.exp}> = str.exp

CAUTION:

The behavior of the replace() function with attribute 0 is undefined and should be avoided.

Example(s)

In these examples, value 1 of attribute 1 in the first element of the dimensioned array, customer.item, is replaced with the data value in the variable name.

customer.item(1) = replace(customer.item(1),1,1,0,name)
customer.item(1) = replace(customer.item(1),1,1;name)

This can alternately be coded as:

customer.item(1)<1,1> = name

The statements below add a new value at the end of attribute 1 of string.

string<1,-1> = value
string = replace(string,1,-1,0,value)
string = replace(string,1,-1;value)