CBREAK(3XCURSES) X/Open Curses Library Functions CBREAK(3XCURSES)
NAME
cbreak, nocbreak, noraw, raw - set input mode controls
SYNOPSIS
cc [
flag... ]
file...
-I /usr/xpg4/include
-L /usr/xpg4/lib \
-R /usr/xpg4/lib
-lcurses [
library... ]
c89 [
flag... ]
file...
-lcurses [
library... ]
#include <curses.h>
int cbreak(
void);
int nocbreak(
void);
int noraw(
void);
int raw(
void);
DESCRIPTION
The
cbreak() function enables the character input mode. This
overrides any previous call to the
raw() function and turns the
stty flag
ICANON off.
The
nocbreak() function sets the line canonical mode and turns the
stty flag
ICANON on without touching the
ISIG or
IXON flags.
The
noraw() function sets the line canonical mode and turns the
stty flags
ICANON,
ISIG, and
IXON all on.
The
raw() function sets the character input mode and turns the
stty flags
ICANON,
ISIG, and
IXON all off. This mode provides maximum
control over input.
It is important to remember that the terminal may or may not be in
character mode operation initially. Most interactive programs
require
cbreak() to be enabled.
RETURN VALUES
On success, these functions return
OK. Otherwise, they return
ERR.
ERRORS
None.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+
SEE ALSO
getch(3XCURSES),
halfdelay(3XCURSES),
libcurses(3XCURSES),
nodelay(3XCURSES),
timeout(3XCURSES),
termio(4I),
attributes(7),
standards(7) June 5, 2002 CBREAK(3XCURSES)