1curs_inch(3CURSES)         Curses Library Functions         curs_inch(3CURSES)
2
3
4

NAME

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

SYNOPSIS

10       cc [ flag ... ] file ... -lcurses [ library ... ]
11       #include <curses.h>
12
13       chtype inch(void);
14
15
16       chtype winch(WINDOW *win);
17
18
19       chtype mvinch(int y, int x);
20
21
22       chtype mvwinch(WINDOW *win, int y, int x);
23
24

DESCRIPTION

26       With these routines, the character, of  type  chtype,  at  the  current
27       position in the named window is returned. If any attributes are set for
28       that position, their values are OR-ed into  the  value  returned.  Con‐
29       stants defined in <curses.h> can be used with the logical AND (&) oper‐
30       ator to extract the character or attributes alone.
31
32   Attributes
33       The following bit-masks can  be  AND-ed  with  characters  returned  by
34       winch().
35
36       A_CHARTEXT      Bit-mask to extract character
37
38
39       A_ATTRIBUTES    Bit-mask to extract attributes
40
41
42       A_COLOR         Bit-mask to extract color-pair field information
43
44

ATTRIBUTES

46       See attributes(5) for descriptions of the following attributes:
47
48
49
50
51       ┌─────────────────────────────┬─────────────────────────────┐
52       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
53       ├─────────────────────────────┼─────────────────────────────┤
54       │MT-Level                     │Unsafe                       │
55       └─────────────────────────────┴─────────────────────────────┘
56

SEE ALSO

58       curses(3CURSES), attributes(5)
59

NOTES

61       The header <curses.h> automatically includes the headers  <stdio.h> and
62       <unctrl.h>.
63
64
65       Note that all of these routines may be macros.
66
67
68
69SunOS 5.11                        31 Dec 1996               curs_inch(3CURSES)