NAME

inputS - read string

SYNOPSIS

#include <basic/string.h>

struct string inputS(n)
short n;

DESCRIPTION

InputS returns a string consisting of n characters read from the current file (see initio(io)).  It is legal to read sequentially from a random file provided the read is entirely within the buffer.  Characters read from a full-duplex tty are not echoed (see io(inc)).  For a tty with a time limit, the limit is enforced (see io(inc) and alarm(io)). 

This function implements the BASIC INPUT$ function. 

This function resets the current file. 

SEE ALSO

io(inc), string(inc), alarm(io)
input$(func)

DIAGNOSTICS

Error 5 (Illegal function call) is generated if the file is open for output only or if n is negative. 

Error 62 (Input past end) is generated if less than n characters are available either due to end-of-file, end-of-record, or time-out. 

from The Basmark QuickBASIC Programmerís Manual by Lawrence Leinweber