# curs_inch 3x

    curs_inch(3x)                                             curs_inch(3x)

## NAME

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

## SYNOPSIS

           #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  named  window.   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  may  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

## RETURN VALUE

           Functions with a "mv" prefix first perform a cursor  move-
           ment  using  wmove, and return an error if the position is
           outside the window, or if the window pointer is null.

## NOTES

           Note that all of these routines may be macros.

## PORTABILITY

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

## SEE ALSO

           curses(3x).

           Comparable  functions  in  the  wide-character  (ncursesw)
           library are described in curs_in_wch(3x).

                                                              curs_inch(3x)