Guide Section: Processing Object Data | EASAP Tree: DATA PROCESSING → LIST

REPEATED EXPAND is similar to SCALAR EXPAND except that lines of text defined in Value: or File: get repeated into a LIST. In this way one or more LIST or SCALAR references are 'expanded' into lines.

The list size or number of expand iterations for a REPEATED EXPAND is determined from the size of the LIST(s) in Value:

All LIST references in Value: or File: must be the same length.

The default Expansion Separator: is a comma → ,

REPEATED EXPAND
Optional Parameters:
Value:	sequence of literal text and object references to expand into one or more lines for insertion into a batch input file
File:	name of file containing line(s) of text used instead of Value: (object references allowed)
Delimiter:	character to delimit SCALAR or LIST references in Value: above. default→%
Expansion separator:	separator used between the values in the list when expanding it, default→COMMA or ,
Encoding:	text encoding used in File: default→US-ASCII
Value on Error:	value to return if the expansion fails

If multiple lines of text are entered for the Value: parameter, the new lines created by typing the <ENTER> are displayed in the parameter table as spaces.

Expansion Separator: defines the string inserted between successive iterations of the resulting REPEATED EXPAND.

• some possible separators
  • <SPACE>
  • <TAB>
  • <NEWLINE> (ie. type <ENTER>)
  • Forward slash → /
  • Backward slash → \

To create a single line of output per 'expand' iteration use a <NEWLINE> separator. This is useful to create input for a batch process or on a results page. A <NEWLINE> typed into the Expansion Separator: field in the parameter window will be displayed as a space. To see <NEWLINE> displayed as a blank line, open the Long Text 'popup' window. Click ellipsis icon () and type the <ENTER> key, <NEWLINE> behaves as expected with the cursor now below the blank line.