Technical Reference: Base Operating System and Extensions , Volume 2

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);

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The doupdate (doupdate, refresh, wnoutrefresh, or wrefresh Subroutines), getch (getch, mvgetch, mvwgetch, or wgetch Subroutine), and initscr (initscr and newterm Subroutine) subroutines.

Curses Overview for Programming in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.

List of Curses Subroutines in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.

Setting Video Attributes and Curses Options in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.