Docs » Autodocs » dos.library » WaitForChar
WaitForChar -- Determine if chars arrive within a time limit
status = WaitForChar( file, timeout )
D0 D1 D2
BOOL WaitForChar(BPTR, LONG)
If a character is available to be read from 'file' within the
time (in microseconds) indicated by 'timeout', WaitForChar()
returns -1 (TRUE). If a character is available, you can use Read()
to read it. Note that WaitForChar() is only valid when the I/O
stream is connected to a virtual terminal device. If a character is
not available within 'timeout', a 0 (FALSE) is returned.
Due to a bug in the timer.device in V1.2/V1.3, specifying a timeout
of zero for WaitForChar() can cause the unreliable timer & floppy
disk operation.
file - BCPL pointer to a file handle
timeout - integer
status - boolean
Read(), FGetC()
|
