typeahead Subroutine
Purpose
Controls checking for typeahead.
Library
Curses Library (libcurses.a)
Syntax
#include <curses.h>
int typeahead
(int fildes);
Description
The typeahead subroutine controls the detection of typeahead during a refresh, based on the value of fildes:
- If fildes is a valid file descriptor, the typeahead subroutine is enabled during refresh; Curses periodically checks fildes for input and aborts refresh if any character is available. (This is the initial setting, and the typeahead file descriptor corresponds to the input file associated with the screen created by the initscr or newterm subroutine.) The value of fildes need not be the file descriptor on which the refresh is occurring.
- If fildes is -1, Curses does not check for typeahead during refresh.
Parameters
Item | Description |
---|---|
fildes |
Return Value
Upon successful completion, the typeahead subroutine returns OK. Otherwise, it returns ERR.
Example
To turn typeahead checking on, enter:
typeahead(1);