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

Return Value

Upon successful completion, the typeahead subroutine returns OK. Otherwise, it returns ERR.

Example

To turn typeahead checking on, enter:

typeahead(1);