curs_inwch(S)

curs_inwch: inwch, winwch, mvinwch, mvwinwch -- get a wchar_t character and its attributes from a curses window

Syntax

cc ... -lcurses

#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 wchar_t character, of type chtype, at the current position in the specified window. If any attributes are set for that position, their values are ORed into the value returned. 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 can be ANDed with characters returned by winwch(S).

A_CHARTEXT: Bit-mask to extract character
A_ATTRIBUTES: Bit-mask to extract attributes
A_COLOR: Bit-mask to extract color-pair field information

Return values

Upon successful completion, the wchar_t character is returned. All routines return ERR on failure.

Warning

The header file curses.h automatically includes the header files stdio.h and unctrl.h.

All of these routines can be macros.

Files

/usr/lib/libcurses.a: the library

Standards conformance

inwch(S), winwch(S), mvinwch(S), and mvwinwch(S) are not part of any currently supported standard; they are extensions of AT&T System V developed by The Santa Cruz Operation, Inc. and maintained by The SCO Group.