The .readnext command extracts the top entry of an active list created by one of the list-generating commands prior to output and inserts the value into the text of the item.
Syntax
.readnext |
Description
The .readnext command is used to read data from an active list. It has an effect only if, prior to entering Runoff, a select, sselect, qselect or get-list statement has been entered, which selects a list of values. Each .readnext command in Runoff extracts the next value from the active list and places it in the text stream.
This command does not cause a break. If there is no active list, or when the list is exhausted, the .readnext command causes a termination of Runoff, and a return to TCL.
See Also
.break Command, .chain Command, Active List, get-list Command, qselect Command, Runoff Commands, select Command, sselect Command