User Tools

Site Tools


REPEATED EXPAND

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

Value:

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:

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.