Output processorOutput processor commands.readnext command (Output processor)

.readnext command (Output processor)

The .readnext command reads data, one value at a time from an active list. It has an affect only if prior to entering the Output processor a select, sselect, qselect, or get-list statement has been executed.

Syntax

.readnext

Synonym(s)

.rn

Description

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

Note: The .readnext command does not cause a break.

If there is no preselected list, or when the list is exhausted, the .readnext command terminates the Output processor and returns to the calling process.

Example(s)

Dear .readnext
You are the only one for me.
Love,
Pat
.chain love.letter

See also

.break command (Output processor), .chain command (Output processor), .readnext null command, Active list, Output processor commands, get-list command, Output processor overview, qselect command, nselect command, sselect command

Parent topic: Output processor commands