FILE_OPEN_WRITE

FILE_OPEN_WRITE N,S

CREATES A TEXT FILE TO WRITE, WITH NUMBER N AND THE NAME S

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

ACTION

The command FILE_OPEN_WRITE N,S creates a new text file named S and gives it the file number N. The number N will be used to designate the file.

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

Remark: if an existing file has the same name S, it is cancelled (then lost) and replaced by the new one.

SYNTAX: FILE_OPEN_WRITE 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_WRITE is used to write in a 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.

EXAMPLE

rem create a file and open it for writing

file_open_write 1,"my_file.txt"

rem write a line

file_writeln 1,"Hello !"

rem close it

file_close 1

SEE ALSO

FILE_CLOSE

FILE_EOF()

FILE_OPEN_APPEND

FILE_OPEN_READ

FILE_READ

FILE_READBUF

FILE_READLN

FILE_READLN$()

FILE_WRITE

FILE_WRITEBUF

FILE_WRITELN