NAME
        WaitForChar -- Determine if chars arrive within a time limit

    SYNOPSIS
        status = WaitForChar( file, timeout )
        D0                    D1    D2

        bool waitforchar(bptr, long)

    FUNCTION
        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.

    BUGS
        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.

    INPUTS
        file - BCPL pointer to a file handle
        timeout - integer

    RESULTS
        status - boolean

    SEE ALSO
        read(), fgetc()