DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

curs_inch(S)


curs_inch: inch, winch, mvinch, mvwinch -- get a character and its attributes from a curses window

Syntax

cc ... -lcurses

#include <curses.h>

chtype inch(void); chtype winch(WINDOW *win); chtype mvinch(int y, int x); chtype mvwinch(WINDOW *win, int y, int x);

Description

These routines return the 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 winch(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

All routines return ERR on failure and a chtype value other than ERR on successful completion.

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

inch(S), winch(S), mvinch(S), and mvwinch(S) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003