.TH TICKIT_TERM_INPUT_WAIT_MSEC 3
.SH NAME
tickit_term_input_wait_* \- read more data from the terminal
.SH SYNOPSIS
.EX
.B #include <tickit.h>
.sp
.BI "void tickit_term_input_wait_msec(TickitTerm *" tt ", long " msec );
.BI "void tickit_term_input_wait_tv(TickitTerm *" tt ", const struct timeval *" timeout );
.EE
.sp
Link with \fI\-ltickit\fP.
.SH DESCRIPTION
The \fBtickit_term_input_wait_*\fP() family of functions wait for at least one input event to be received, up until the maximum time given. Calling these functions may block if the underlying file descriptor is in blocking mode. They may result in \fBTICKIT_EV_KEY\fP or \fBTICKIT_EV_MOUSE\fP events being invoked.
.PP
These functions also invoke deferred \fBTICKIT_EV_RESIZE\fP events if enabled by \fBtickit_term_observe_sigwinch\fP(3).
.PP
The functions differ in how the timeout is specified. \fBtickit_term_input_wait_msec\fP() takes a time as an integer in milliseconds, or -1 to wait indefinitely. \fBtickit_term_input_wait_tv\fP() takes a time as a \fIstruct timeval\fP, or \fBNULL\fP to wait indefinitely.
.SH "RETURN VALUE"
\fBtickit_term_input_wait_msec\fP() and \fBtickit_term_input_wait_tv\fP() return no value.
.SH "SEE ALSO"
.BR tickit_term_build (3),
.BR tickit_term_input_readable (3),
.BR tickit_term_bind_event (3),
.BR tickit_term (7),
.BR tickit (7)