Read ASCII Line (Iterator)

Reads one or more boolean, integer, double, string, vector, transform, or double lists values from a line in an ASCII file. This command allows the script writer to define the number and type return arguments

 

Input Arguments

 

0

Integer

ASCII File Handle

The handle of the open ASCII file to read from.

1

Integer

Line Index

The line to start reading from.

2

Step ID

Step to Jump at End of List

The step to jump to once the iterator has finished reading all lines from the file.

Return Arguments

Matching the items added to the list to be read from the file. To add arguments select the step in your script. When you do, additional buttons will appear at the top of the MP editor providing Add, Remove, Edit and Read controls


 

Returned Status

 

SUCCESS

The file was read successfully.

FAILURE

The file path is invalid or the referenced items could not be found.

 

Remarks

A valid file handle that has previously been opened must be provided. The line index is zero-based, so the first line in the file is line zero.

You can jump to a specific comma-delimited entry in the line by using the Add Column to Read button, in which you

 

specify the zero-based column to read from. This will place the “cursor” at this column in preparation for reading an item, which is defined by clicking the Add button.

You can jump around to different nonsequential columns in this way.