DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

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

See also

curses(S)

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.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003