[ Character I/O | Reference Manual | Alphabetic Index ]

nl(+Stream)

A newline is printed on the output stream Stream.
Stream
Stream handle or alias (atom)

Description

Used to print a newline sequence on the output stream Stream. The exact character sequence emitted depends on the setting of the stream's end_of_line flag (lf or crlf). In addition, if the stream's flush flag is set to end_of_line, the stream is also flushed.

Modes and Determinism

Exceptions

(4) instantiation fault
Stream is not instantiated.
(5) type error
Stream is neither an atom nor a number.
(192) illegal stream mode
Stream is not an output stream.
(193) illegal stream specification
Stream is an illegal stream specification.

Examples

   Success:
      open(file1,update,s), nl(s), close(s).
      nl(output).
Error:
      nl(Stream).               (Error 4).
      nl(7.0).                  (Error 5).
      open(file1,read,s),nl(s). (Error 192). % read mode
      nl(29).                   (Error 192). % stream not open
      nl(-1).                   (Error 193). % out of range
      nl(30).                   (Error 193). % out of range
      nl(atom).                 (Error 193). % no such stream



See Also

nl / 0, writeln / 2, flush / 1, open / 4, set_stream_property / 3, get_stream_info / 3