UNGETCH(3XCURSES) X/Open Curses Library Functions UNGETCH(3XCURSES)

NAME

ungetch, unget_wch - push character back onto the input queue

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 ungetch(int ch);


int unget_wch(const wchar_t wch);

PARAMETERS

ch
Is the single byte character to be put back in the input queue
for the next call to getch(3XCURSES).


wch
Is the wide character to be put back in the input queue for
the next call to get_wch(3XCURSES).

DESCRIPTION

The ungetch() function pushes ch back onto the input queue until the
next call to getch().


The unget_wch() function is similar to ungetch() except that ch can
be of type wchar_t.

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

get_wch(3XCURSES), getch(3XCURSES), libcurses(3XCURSES),
attributes(7), standards(7)

June 5, 2002 UNGETCH(3XCURSES)