NAME

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

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 );

LIBRARY

Curses Library (libcurses)

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_COLOR
Bit-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. Use the ∗in_wch functions in new applications (see curs_in_wch(3)). 

SEE ALSO

Functions: curses(3), curs_in_wch(3)