Application icon

Get Next Line

This function is used to extract the next line from the contents of a named variable which were set by the Read Text File function. The next line is stored in the specified destination variable or named variable. The named variable has its contents adjusted by removing the extracted data.

The next line is defined as all data up to the next return character, linefeed character or return-linefeed character pair. If there is no line terminator and the named variable is not empty, the entire contents of the named variable will be returned. The line terminator is not stored in the destination variable.

If there is no more data in the named variable, an empty string will be stored in the destination variable. The action's test state is set to True when data is returned or False when the data has been exhausted.

This statement is the most efficient method of successively processing data read by the Read Text File statement.

All text fields may contain any of the escape sequences described in Escape Sequences.

When executed stepwise a single data line is extracted and stored in the specified named variable or in the specified track variable in all files being manipulated.