FLUSH - force I/O to end of line.

Alternate Entry Name: .FLUSH

Usage:

B:
   flush( [unit] );

/* C programs use "fflush" */

Where:

unit: is the number of an I/O unit. If not specified, it defaults to the current write unit.

Description:

FLUSH causes the current line to be forced to an end of line condition. On output to a file, this means that a '*n' is written. On output to a terminal-type device, the current line is immediately sent to the device without modification.

On any input unit, the remainder of the current line, up to and including the '*n', is thrown away. Note that if the last character read was a '*n', this will throw away the next line.

FLUSH is not needed to synchronize output to the terminal with input from that device.