.readnext Command (Runoff)

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