(C) 1998 AROS - The Amiga Research OS


NAME
#include <proto/dos.h>
#include <exec/types.h>

BOOL WaitForChar (file , timeout)

LOCATION
In DOSBase at offset 34

SYNOPSIS
BPTR file
LONG timeout

FUNCTION
Wait for a character to arrive at a filehandle. The filehandle can be either a console handle, or a regular file. For a regular file most filesystems will return a character immediately, but sometimes (for example a network handler) the character may not have arrived.

INPUTS
file
File to wait for a character on.
timeout
Number of microseconds to wait for the character to arrive. A value of 0 says to wait indefinately.
RESULT
!= 0 if a character arrived before the timeout expired == 0 if no character arrived

EXAMPLE

SEE ALSO

NOTES
Many filesystems do not implement this function.

BUGS

INTERNALS

HISTORY
20.10.1998 hkiel
Amiga Research OS
24.12.1997 iaint
Added documentation
05.12.1997 srittau
New function
27.01.1997 ldp
Polish
09.12.1996 aros
Added empty templates for all missing functions

Moved #include's into first column