FILE_OPEN_READ

FILE_OPEN_READ N,S

OPENS A TEXT FILE TO BE READ, WITH NUMBER N AND NAME S

  • Type: Command
  • Parameters: 2
  • Group: Text Files

ACTION

The command FILE_OPEN_READ N,S opens an existing text file named S, and gives it the file number N. The number N will be used to designate the file.

The open file can then be used through the appropriated commands.

SYNTAX: FILE_OPEN_READ N,S

  • N = file number (integer or real). Must be greater than 0 and less than or equal to the maximum of allowed text file number.
  • S = string. Absolute or relative file name.

USE

  • The command FILE_OPEN_READ is used to read in an existing text file.

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the maximum of allowed text file number.
  • If number N is already used for an open text file. (closing a file frees its number)
  • If S is not a correct file name.
  • If text file named S does not exist.

EXAMPLE

dim a$

rem open a text file for reading

file_open_read 1,"my_file.txt"

rem print all its lines

while file_eof(1) <> 1

file_readln 1,a$:print a$

end_while

rem close it

file_close 1

SEE ALSO

FILE_CLOSE

FILE_EOF()

FILE_OPEN_APPEND

FILE_OPEN_WRITE

FILE_READ

FILE_READBUF

FILE_READLN

FILE_READLN$()

FILE_WRITE

FILE_WRITEBUF

FILE_WRITELN