NAME

curs_inwch, inwch, winwch, mvinwch, mvwinwch − Get a wchar_t character and its attributes from a Curses window

LIBRARY

Curses Library (libcurses.a, libcurses.so)

SYNOPSIS

#include <curses.h>

chtype inwch(void);
chtype winwch(WINDOW ∗win);
chtype mvinwch(int y, int x);
chtype mvwinwch(WINDOW ∗win, int y, int x);

DESCRIPTION

These routines return the wide character, of type chtype, at the current or specified position in the current or specified window.  If any attributes are set for that position, their values included in the returned value through an inclusive OR operation.  Constants defined in curses.h can be used with the & (logical AND) operator to extract the character or attributes alone. 

Attributes

The following bit-masks may be used (logical AND operation) with characters returned by winwch:

A_CHARTEXT
Bit-mask to extract character

A_ATTRIBUTES
Bit-mask to extract attributes

A_COLORBit-mask to extract color-pair field information

NOTES

The header file curses.h automatically includes the header file stdio.h. 

Note that all of these routines except winwch may be macros. 

The routines described on this reference page are among the MNLS Curses functions that are not included in the X/Open Curses CAE specification.  MNLS routines are supported only for backward compatibility reasons. Digital recommends the use of the ∗in_wch functions in new applications (see curs_in_wch(3)). 

RELATED INFORMATION

Functions: curses(3), curs_in_wch(3)