nl(3curses)

nl -- enable/disable newline translation

Synopsis

cc [options] file -lcurses

#include <curses.h>

int nl(void);

int nonl(void);

Description

The nl(3curses) function enables a mode in which carriage return is translated to newline on input. The nonl(3curses) function disables the above translation. Initially, the above translation is enabled.

Return value

Upon successful completion, these functions return OK. Otherwise, they return ERR.

Errors

No errors are defined.

Usage

The default translation adapts the terminal to environments in which newline is the line termination character. However, by disabling the translation with nonl(3curses), the application can sense the pressing of the carriage return key.

Standards Conformance

The Single UNIX Specification, Version 2; The Open Group.

References

curses(4)