'\" te .\" Copyright (c) 1990, 1995 by Mortice Kern Systems Inc. All Rights Reserved Portions Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved .TH typeahead 3XCURSES "5 Jun 2002" "SunOS 5.11" "X/Open Curses Library Functions" .SH NAME typeahead \- check for type-ahead characters .SH SYNOPSIS .LP .nf \fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-I\fR /usr/xpg4/include \fB -L \fR /usr/xpg4/lib \e \fB -R \fR /usr/xpg4/lib \fB -lcurses \fR [ \fIlibrary\fR... ] \fBc89\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lcurses\fR [ \fIlibrary\fR... ] #include \fBint\fR \fBtypeahead\fR(\fBint\fR \fIfd\fR); .fi .SH PARAMETERS .sp .ne 2 .mk .na \fB\fIfd\fR\fR .ad .RS 6n .rt Is the file descriptor that is used to check for type-ahead characters. .RE .SH DESCRIPTION .sp .LP The \fBtypeahead()\fR function specifies the file descriptor (\fIfd\fR) to use to check for type-ahead characters (characters typed by the user but not yet processed by X/Open Curses). .sp .LP X/Open Curses checks for type-ahead characters periodically while updating the screen. If characters are found, the current update is postponed until the next \fBrefresh\fR(3XCURSES) or \fBdoupdate\fR(3XCURSES). This speeds up response to commands that have been typed ahead. Normally, the input file pointer passed to \fBnewterm\fR(3XCURSES), or \fBstdin\fR in the case of \fBinitscr\fR(3XCURSES), is used for type-ahead checking. .sp .LP If \fIfd\fR is -1, no type-ahead checking is done. .SH RETURN VALUES .sp .LP On success, the \fBtypeahead()\fR function returns \fBOK\fR. Otherwise, it returns \fBERR\fR. .SH ERRORS .sp .LP None. .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 _ Interface StabilityCommitted _ MT-LevelUnsafe _ StandardSee \fBstandards\fR(5). .TE .SH SEE ALSO .sp .LP \fBdoupdate\fR(3XCURSES), \fBgetch\fR(3XCURSES), \fBinitscr\fR(3XCURSES), \fBlibcurses\fR(3XCURSES), \fBattributes\fR(5), \fBstandards\fR(5)