op.readnext Command/Output Processor: Commands

op.readnext

Command op.readnext Command/Output Processor: Commands
Applicable release versions: AP
Category Output Processor: Commands (183)
Description reads data, one value at a time, from an "active list".

It has an effect only if, prior to entering OP, a "select", "sselect", "qselect" or "get-list" statement has been executed.

Each ".readnext" command in OP 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 pre-selected list, or when the list is exhausted, the ".readnext" command terminates OP, and returns to the calling process.
Syntax .readnext
.rn
Options
Example
Dear .readnext 

  You are the only one for me.

Love,

Pat
.chain love.letter
Purpose
Related op.readnext.null
op.rn
active.list
access.select
access.sselect
op.break
op.chain
op.commands
tcl.get-list
tcl.qselect
op