FileTools[Text][Open] - open a file for buffered reading or writing
|
Calling Sequence
|
|
Open(name, opt1, opt2, ...)
|
|
Parameters
|
|
name
|
-
|
name of the file to be opened
|
opt1, opt2, ...
|
-
|
(optional) argument of the form where option is one of create, overwrite, or append
|
|
|
|
|
Description
|
|
•
|
The Open(name) command opens a file for reading and writing of text data.
|
•
|
There are three optional arguments: create, overwrite, and append. Each accept a boolean value.
|
|
The create optional argument determines the behavior when file does not exist. If create is true, then file is created. If create is false, an error is raised. If file does exist, this argument has no effect. By default, create is true.
|
|
overwrite = true or false
|
|
The overwrite optional argument determines the behavior when file does exist. If overwrite is true, then the file is overwritten. If overwrite is false, the contents of the previous file are visible. If file does not exist, this argument has no effect. By default, overwrite is false.
|
|
The append optional argument determines the initial file position after file has been opened. If append is true, then the initial file position is at the end of the file; otherwise, it is at the beginning of the file. If file is created or overwrites a previous value, this argument has no effect. By default, append is false.
|
•
|
In many cases, it is not necessary to Open a file in order to access it. The first operation performed on a file opens it. The Open function allows you to control the opening mode.
|
•
|
If the file being opened is already open, Open raises an error.
|
•
|
If the limit for the maximum number of simultaneously open files has been reached, Open raises an error.
|
•
|
For information on filenames, see file.
|
|
|