File
From OpenEUO
Calling Pattern
Call
local f = sl.file(a,b)
Args
a is a string, the filename b is a string, the mode, either 'read' or 'write'
Results
f is a structured file object
Usage Example
local t = {[3.14] = 0.7071, [' una ']=1, test='Some "random" string.'}
local f = sl.file(getinstalldir()..'scripts/testwrite.dat', 'write')
f.write(t)
f.finalize()
f = nil
local g = sl.file(getinstalldir()..'scripts/testwrite.dat', 'read')
local v = g.readnext()
g = nil
print(sl.keyvalstr(v))
--> table keys:values = {
una :1,
test:Some "random" string.,
3.14:0.7071,
}
Description
Creates a file object for structured file handling, allowing one to read or write sequences of values (nils, nulls, booleans, numbers, strings, and tables) to a file. Caution: Opening an existing file in 'write' mode overwrites any existing contents.
Methods
If opened in 'write' mode, the following methods are available:
If opened in 'read' mode, these methods are available:
Upon Error
File fails if it receives improper arguments, if an improper mode is specified, or if the file specified cannot be opened. Failures are handled according to the error redirection mode in effect.
