Variable Entries

To change the elements of a delimited list, use the Variable Entries section.

The contents of the Entries field must use this syntax:

var, [delimiter,] pos = scalarExpr

where:

  • var is the name of an event variable that contains a string comprised of zero or more elements separated by the delimiter character.
  • delimiter is the character or string which separates elements in var from each other. This argument is optional. If this argument is not used, the comma (,) character is used. In this case, elements can contain commas only if they are enclosed within a ~LIT~(…) wrapper.
  • pos is the 1-based position of the element to change.
  • scalarExpr is the value to whose string representation the element is to be set.

If multiple elements of the same variable are to be changed, include their positions and values as additional entries separated by commas; for example:

var, [delimiter,] pos1 = scalarExpr1, pos2 = scalarExpr2[, ...]

When you click OK to return to the Event Actions form, the application "wraps" this content within a SETVARENTRIES ( ) parameter, which yields this final syntax:

SETVARENTRIES( var, [delimiter,] pos = scalarExpr[, …] )

Note: If a scalarExpr is a literal value, the application automatically encloses it in double quotation marks when returning it to the Event Actions form. If a scalarExpr is an expression, the application does not enclose it in quotation marks.