Digital

NAME

inch, mvinch, mvwinch, winch − return character from window

SYNOPSIS

#include <curses.h>

chtype inch()

chtype winch(win)
WINDOW ∗win;

chtype mvinch(y, x)
int y, x;

chtype mvwinch(win, y, x)
WINDOW ∗win;
int y, x;

DESCRIPTION

The inch routine returns the character at the current cursor position in the default window.  If any attributes are set for that character, their values will be or-ed into the value returned. 

The routine mvinch returns the character at the specified position in the default window.  If any attributes are set for that position, their values will be or-ed into the value returned. 

The winch routine returns the character at the current position in the named window.  If any attributes are set for that position, their values will be or-ed into the value returned. 

The mvwinch routine returns the character at the specified position in the named window.  If any attributes are set for that position, their values will be or-ed into the value returned. 

The following information applies to all the routines. 

The predefined constants A_CHARTEXT and A_ATTRIBUTES, defined in <curses.h>, can be used with the & (logical and) operator to extract the character or attributes alone. 

The inch, winch, mvinch, and mvwinch routines are macros. 

RETURN VALUES

Upon successful completion, the inch, mvinch, mvwinch, and winch functions return the character at the selected position. Otherwise, the mvinch and mvwinch functions return ERR.