LINE INPUT (file statement)
Jump to navigation
Jump to search
Navigation:
The LINE INPUT # file statement reads an entire line from a text file into a string variable.
Syntax
- LINE INPUT #fileNumber&, stringVariable$
Parameters
- fileNumber& is the INTEGER number of the file previously opened with the OPEN statement.
- stringVariable$ holds the text line read from the file.
Description
- Reads a file using the fileNumber& OPENed in the INPUT (file mode) or BINARY file mode as one file line text string.
- NOTE: LINE INPUT will work faster in BINARY mode than in INPUT mode.
- Using LINE INPUT # in BINARY mode is possible in version 1.000 and up
- Can be used with EOF to count the number of lines of data (records) in a file using a loop.
- Use the EOF function to avoid going past the end of a file and creating an error.
- LINE INPUT # can even retain the original quotation marks in text.
- Note: QB64 will not remove CHR$(0) from the end of LINE INPUT # string return values like QBasic did.
Errors
- If an "Input past End of file" error occurs, check for CHR$(26) (end of file character) in the files being read.
- Warning: files must exist to be opened in INPUT mode. Use _FILEEXISTS to avoid program errors.
Examples
Example: Finding the number of filenames listed in a file to dimension an array to hold them.
REDIM FileArray$(100) 'create dynamic array SHELL _HIDE "DIR /B *.* > D0S-DATA.INF" IF _FILEEXISTS("D0S-DATA.INF") THEN OPEN "D0S-DATA.INF" FOR INPUT AS #1 DO UNTIL EOF(1) LINE INPUT #1, file$ 'read entire text file line filecount% = filecount% + 1 LOOP CLOSE #1 END IF REDIM FileArray$(filecount%) PRINT filecount%
See also
- OPEN, CLOSE
- INPUT (file mode), INPUT #, INPUT$ (file input)
- INPUT, LINE INPUT, INPUT$ (keyboard input)
- _FILEEXISTS, _DIREXISTS
- FILELIST$ (member-contributed function replacement for FILES)
