Go to main content

man pages section 3: Curses Library Functions

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
Unsafe
Standard

See Also

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