Go to main content

man pages section 3: Curses Library Functions

Exit Print View

Updated: Thursday, June 13, 2019
 
 

curs_inch(3CURSES)

Name

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

Synopsis

cc [ flag ... ] file ... –lcurses [ library ... ]
#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

With these routines, the character, of type chtype, at the current position in the named window is returned. If any attributes are set for that position, their values are OR-ed 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 AND-ed with characters returned by winch().

A_CHARTEXT

Bit-mask to extract character

A_ATTRIBUTES

Bit-mask to extract attributes

A_COLOR

Bit-mask to extract color-pair field information

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
MT-Level
Unsafe

See Also

curses(3CURSES), attributes(7)

Notes

The header <curses.h> automatically includes the headers <stdio.h> and <unctrl.h>.

Note that all of these routines may be macros.