1curs_inch(3X)                                                    curs_inch(3X)
2
3
4

NAME

6       inch,  winch,  mvinch,  mvwinch - get a character and attributes from a
7       curses window
8

SYNOPSIS

10       #include <curses.h>
11
12       chtype inch(void);
13       chtype winch(WINDOW *win);
14       chtype mvinch(int y, int x);
15       chtype mvwinch(WINDOW *win, int y, int x);
16

DESCRIPTION

18       These routines return the character, of type  chtype,  at  the  current
19       position in the named window.  If any attributes are set for that posi‐
20       tion, their values  are  OR'ed  into  the  value  returned.   Constants
21       defined  in <curses.h> can be used with the & (logical AND) operator to
22       extract the character or attributes alone.
23
24   Attributes
25       The following bit-masks may  be  AND-ed  with  characters  returned  by
26       winch.
27
28       A_CHARTEXT     Bit-mask to extract character
29       A_ATTRIBUTES   Bit-mask to extract attributes
30       A_COLOR        Bit-mask to extract color-pair field information
31

RETURN VALUE

33       Functions  with  a  "mv"  prefix  first perform a cursor movement using
34       wmove, and return an error if the position is outside the window, or if
35       the window pointer is null.
36

NOTES

38       Note that all of these routines may be macros.
39

PORTABILITY

41       These functions are described in the XSI Curses standard, Issue 4.
42

SEE ALSO

44       curses(3X).
45
46       Comparable  functions  in  the  wide-character  (ncursesw)  library are
47       described in curs_in_wch(3X).
48
49
50
51                                                                 curs_inch(3X)