The .readnext command reads data, one value at a time from an active list. It has an affect only if prior to entering the Output Processor a select, sselect, qselect, or get-list statement has been executed.
Syntax
.readnext |
Synonym(s)
.rn |
Description
Each .readnext command in the Output Processor extracts the next value from the active list and places it in the text stream.
NOTE |
The .readnext command does not cause a break. |
If there is no preselected list, or when the list is exhausted, the .readnext command terminates the Output Processor and returns to the calling process.
Example(s)
Dear .readnext You are the only one for me. Love, Pat .chain love.letter |
See Also
.break Command, .chain Command, .readnext null Command, Active List, Output Processor Commands, get-list Command, Output Processor Overview, qselect Command, select Command, sselect Command