[ Character I/O | The ECLiPSe Built-In Predicates | Reference Manual | Alphabetic Index ]

# nl(+Stream)

A newline is printed on the output stream Stream.

Stream
  Integer (stream number) or Atom (reserved or user-defined symbolic stream name).

## 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

- nl(+) is det

### 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