'\" te
.\" Copyright 1989 AT&T
.\" Portions Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved.
.TH curs_inch 3CURSES "31 Dec 1996" "SunOS 5.11" "Curses Library Functions"
.SH NAME
curs_inch, inch, winch, mvinch, mvwinch \- get a character and its attributes from a curses window
.SH SYNOPSIS
.LP
.nf
\fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lcurses\fR [ \fIlibrary\fR ... ]
#include <curses.h>

\fBchtype\fR \fBinch\fR(\fBvoid\fR);
.fi

.LP
.nf
\fBchtype\fR \fBwinch\fR(\fBWINDOW *\fR\fIwin\fR);
.fi

.LP
.nf
\fBchtype\fR \fBmvinch\fR(\fBint\fR \fIy\fR, \fBint\fR \fIx\fR);
.fi

.LP
.nf
\fBchtype\fR \fBmvwinch\fR(\fBWINDOW *\fR\fIwin\fR, \fBint\fR \fIy\fR, \fBint\fR \fIx\fR);
.fi

.SH DESCRIPTION
.sp
.LP
With these routines, the character, of type \fBchtype\fR, 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 \fB<curses.h>\fR can be used with the logical AND (\fB&\fR) operator to extract the character or attributes alone.
.SS "Attributes"
.sp
.LP
The following bit-masks can be AND-ed with characters returned by \fBwinch()\fR.
.sp
.ne 2
.mk
.na
\fBA_CHARTEXT\fR
.ad
.RS 16n
.rt  
Bit-mask to extract character
.RE

.sp
.ne 2
.mk
.na
\fBA_ATTRIBUTES\fR
.ad
.RS 16n
.rt  
Bit-mask to extract attributes
.RE

.sp
.ne 2
.mk
.na
\fBA_COLOR\fR
.ad
.RS 16n
.rt  
Bit-mask to extract color-pair field information
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
MT-LevelUnsafe
.TE

.SH SEE ALSO
.sp
.LP
\fBcurses\fR(3CURSES), \fBattributes\fR(5)
.SH NOTES
.sp
.LP
The header <\fBcurses.h\fR> automatically includes the headers  <\fBstdio.h\fR> and <\fBunctrl.h\fR>.
.sp
.LP
Note that all of these routines may be macros.