unget_wch(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(5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Interface Stability Committed MT-Level Unsafe Standard See standards(5).

See also

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