nl/[0,1]

Synopsis

nl

nl(+Stream)

Terminates the current output record on the current output stream or on Stream. See fli-ios-sst-fmt.

Arguments


Stream stream_object
a valid Prolog stream

Description

Wraps the current output record (line) and writes out the record. How the record is wrapped up depends on the format of the output stream.

Exceptions

Stream errors (see ref-iou-sfh-est), plus:


existence_error
Some operating system dependent error occurred in writing.
permission_error
There is an error in the bottom layer of write function of the stream.

Comments

How the wrapped record is written depends upon the bottom layer write function associated with the output stream. The default tty stream displays the wrapped output record to the terminal immediately for each nl/[0,1] operation, while the default text stream under UNIX and Windows does not send the wrapped record (line) to the disk unless the buffer for the output stream is full.

See Also

put/[1,2] flush_output/1.