Futurebasic/Language/Reference/line input pound
LINE INPUT#
[edit | edit source]Syntax
[edit | edit source]LINE INPUT# deviceID, stringVar$
Description
[edit | edit source]This statement reads a line of text data from the open file or open serial port specified by deviceID
, and stores the data into the string variable stringVar$
.
If deviceID
equals zero, then LINE INPUT#
reads data from the keyboard. LINE INPUT#0,stringVar$
is identical to LINE INPUT stringVar$
.
If deviceID
specifies a file, then LINE INPUT#
reads a line of text from the file, beginning at the current "file mark" position (which is usually at the beginning of the line), and ending when a carriage-return character is encountered, or the end of the file is encountered, or 255 characters have been read, whichever occurs first. LINE INPUT#
then assigns the entire string of characters to stringVar$
. the file mark is then advanced to a position just past the last character read.
If deviceID
specifies a serial port (i.e., if its value is _modemPort
or _printerPort
), then LINE INPUT#
behaves in a similar way, except that the concepts of "file mark" and "end of file" generally don't apply.
Note that LINE INPUT#
is similar to INPUT#
, except that special characters such as commas, quotes and leading spaces are not interpreted as data item delimiters, but instead are copied directly into stringVar$
.
Note:
If the file mark is already at the end of the file when you execute LINE INPUT#
, FB generates an "Input past end of file" error. To prevent this situation, check the value of EOF(deviceID)
before executing LINE INPUT#
.
See Also
[edit | edit source]INPUT#; LINE INPUT; EOF; OPEN