Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
inch(3XCURSES)		X/Open Curses Library Functions		inch(3XCURSES)

NAME
       inch,  mvinch,  mvwinch,	 winch	- return a single-byte character (with
       rendition)

SYNOPSIS
       cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
       -R /usr/xpg4/lib	-lcurses [ library... ]

       c89 [ flag... ] file... -lcurses	[ library... ]

       #include	<curses.h>

       chtype inch(void);

       chtype mvinch(int y, int	x);

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

       chtype winch(WINDOW *win);

DESCRIPTION
       The inch() and winch() functions	return the chtype character located at
       the  current  cursor position of	the stdscr window  and window win, re-
       spectively. The mvinch()	and  mvwinch()	functions  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/attribute pair will be returned.	 The character
       or attributes can be extracted by performing a bitwise AND on  the  re-
       turned  value,  using  the  constants  A_CHARTEXT,   A_ATTRIBUTES,  and
       A_COLOR.

PARAMETERS
       y	Is the y (row) coordinate of the position of the character  to
		be returned.

       x	Is  the	x (column) coordinate of the position of the character
		to be returned.

       win	Is a pointer to	the window that	contains the character	to  be
		returned.

RETURN VALUES
       On  success,  these functions return the	specified character and	rendi-
       tion. Otherwise,	they return ERR.

ERRORS
       None.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       addch(3XCURSES),	attroff(3XCURSES), libcurses(3XCURSES),	attributes(5),
       standards(5)

SunOS 5.10			  5 Jun	2002			inch(3XCURSES)

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=inch&sektion=3xcurses&manpath=SunOS+5.10>

home | help