inch winch mvinch mvwinch

The inch set of routines is used to return a character (with attributes).

Syntax

   #include <curses.h>



   chtype inch;

   chtype winch(WINDOW *win);



   chtype mvinch(int y, int x);

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

Parameters

ch: The character to be returned.
win: A pointer to the window that contains the character to be returned.
x: The x (column) coordinate of the position of the character to be returned.
y: The y (row) coordinate of the position of the character to be returned.

Return Values

The chtype () character from the screen location.

Description

The inch() and winch() routines return the chtype character located at the current cursor position of the stdscr window and window win, respectively. The mvinch() and mvwinch() routines return the chtype character located at the position indicated by the x (column) and y (row) parameters (the former in the stdscr window; the latter in window win).

The complete character and attribute pair is returned. The character or attributes can be extracted by performing a bitwise AND on the returned value, using the constants A_CHARTEXT, A_ATTRIBUTES, and A_COLOR defined in curses.h.




	NOTE: All of these routines are macros.

Implementation Considerations

Identical to XPG/3

Portability

UNIX System V, XPG/3

inch winch mvinch mvwinch

Technical documentation

» Table of Contents

» Index