CURS_INWCH(3CURSES) Curses Library Functions CURS_INWCH(3CURSES)
curs_inwch, inwch, winwch, mvinwch, mvwinwch - get a wchar_t
character and its attributes from a curses window
cc [ flag ... ] file ... -lcurses [ library .. ]
#include <curses.h>
chtype inwch(void);
chtype winwch(WINDOW *win);
chtype mvinwch(int y, int x);
chtype mvwinwch(WINDOW *win, int y, int x);
These routines return the wchar_t character, of type chtype, at the
current position in the named window. If any attributes are set for
that position, their values are OR-ed into the value returned.
Constants defined in <curses.h> can be used with the logical AND (&)
operator to extract the character or attributes alone.
The following bit-masks may be AND-ed with characters returned by
winwch().
A_WCHARTEXT Bit-mask to extract character
A_WATTRIBUTES Bit-mask to extract attributes
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+
curses(3CURSES), attributes(7)
The header file <curses.h> automatically includes the header files
<stdio.h>, <unctrl.h> and <widec.h>.
Note that all of these routines may be macros.
None of these routines can use the color attribute in chtype.
December 31, 1996 CURS_INWCH(3CURSES)
NAME
curs_inwch, inwch, winwch, mvinwch, mvwinwch - get a wchar_t
character and its attributes from a curses window
SYNOPSIS
cc [ flag ... ] file ... -lcurses [ library .. ]
#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 named window. If any attributes are set for
that position, their values are OR-ed 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 may be AND-ed with characters returned by
winwch().
A_WCHARTEXT Bit-mask to extract character
A_WATTRIBUTES Bit-mask to extract attributes
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+
SEE ALSO
curses(3CURSES), attributes(7)
NOTES
The header file <curses.h> automatically includes the header files
<stdio.h>, <unctrl.h> and <widec.h>.
Note that all of these routines may be macros.
None of these routines can use the color attribute in chtype.
December 31, 1996 CURS_INWCH(3CURSES)