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

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.