Difference between revisions of "File"
From OpenEUO
m |
m (→Object Methods) |
||
| Line 31: | Line 31: | ||
[[file.skip]] | [[file.skip]] | ||
| + | |||
| + | [[file.stream]] | ||
== Usage Example == | == Usage Example == | ||
Revision as of 18:31, 24 November 2010
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 handling object (not the same as a lua file object)
Object Methods
If opened in 'write' mode, the following methods are available:
If opened in 'read' mode, these methods are available:
Usage Example
local t = {[3.14] = 0.7071, [' una ']=1, test='Some "random" string.'}
local f = sl.file(getinstalldir()..'scripts/testwrite.dat', 'write')
f.tofile(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 structured file handling object 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.
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.
