HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

notimeout(3X) notimeout(3X)

(ENHANCED CURSES)

NAME

notimeout, timeout, wtimeout — control blocking on input

SYNOPSIS

#include <curses.h>

int notimeout(WINDOW *win, bool bf);

void timeout(int delay);

void wtimeout(WINDOW *win, int delay);

DESCRIPTION

The notimeout() function speciﬁes whether Timeout Mode or No Timeout Mode is in effect for the

screen associated with the speciﬁed window. If bf is TRUE, this screen is set to No Timeout Mode. If bf is

FALSE, this screen is set to Timeout Mode. The initial state is FALSE.

The

timeout() and wtimeout() functions set blocking or non-blocking read for the current or

speciﬁed window based on the value of delay:

delay <0 One or more blocking reads (indeﬁnite waits for input) are used.

delay =0 One or more non-blocking reads are used. Any Curses input function will fail if every

character of the requested string is not immediately available.

delay >0 Any Curses input function blocks for delay milliseconds and fails if there is still no

input.

RETURN VALUE

Upon successful completion, the notimeout() function returns OK. Otherwise, it returns ERR.

The timeout() and wtimeout() functions do not return a value.

ERRORS

No errors are deﬁned.