Difference between revisions of "File"
From OpenEUO
(Created page with "== 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 file object == Usage Exam...") |
m (→Description) |
||
| Line 28: | Line 28: | ||
== Description == | == 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. Opening an existing file in 'write' mode overwrites any existing contents. | + | 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 == | == Methods == | ||
Revision as of 12:02, 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 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.
