runoff.readnext

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.

This 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. See 'active list'.

Each '.readnext' command in Runoff extracts the next value from the active list and places it in the text stream.

'.readnext' 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.