runoff.readnext Command/Runoff: Commands

runoff.readnext

Command runoff.readnext Command/Runoff: Commands
Applicable release versions: AP, R83
Category Runoff: Commands (93)
Description 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.
Syntax
Options
Example
Purpose
Related active.list
access.select
access.sselect
op.break
runoff.chain
runoff.commands
tcl.get-list
tcl.qselect