| Parameters: |
FileHandle
A numeric expression indicating the
handle number of the file to open.
Possible values range from 1 to 10.
Filename
A string expression indicating the path and name of the ASCII file
to open.
Mode
Optional parameter that indicates what should happen if the file
does not exist. This parameter can have the following values:
|
0
|
If the file does not
exist, Open( ) fails with return code 2 (default).
|
|
1
|
If the file does not
exist, Open( ) will create a new file.
|
|
2
|
Opens the file for read
access (default).
|
|
4
|
Opens the file for write
access.
|
Note:
These values are cumulative. So if you want to open a file for write
access, and create it if it does not yet exist, you should specify 5.
Notice, however, that a file can not be opened for read and write access at
the same time.
|
| Remarks: |
Open
opens the ASCII file specified by file
name, for the internal buffer indicated by file
number. KiXtart supports a maximum of ten open files, so file
number must be within the range of 1 to 10.
The file-I/O functions in
KiXtart (Open, ReadLine, and Close)
process small configuration files. They are not intended for larger
operations, such as scanning long files. For the sake of simplicity and
speed, Open reads an entire ASCII file into memory, and subsequent ReadLine
commands read lines stored in memory.
Although
this design is memory-intensive, it is also very fast and simple.
|