File - Revision history

Ximan: /* Object Methods */

2010-12-18T23:14:37Z

‎Object Methods

Ximan: /* Object Methods */

2010-11-25T02:31:57Z

‎Object Methods

Ximan at 02:31, 25 November 2010

2010-11-25T02:31:33Z

Ximan: /* Usage Example */

2010-11-24T19:57:28Z

‎Usage Example

Ximan: /* Calling Pattern */

2010-11-24T19:37:34Z

‎Calling Pattern

Ximan: /* Description */

2010-11-24T19:36:49Z

‎Description

Ximan: /* Calling Pattern */

2010-11-24T19:30:01Z

‎Calling Pattern

Ximan: /* Description */

2010-11-24T19:02:19Z

‎Description

Ximan: 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..."

2010-11-24T19:01:05Z

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..."

New page

== 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. Opening an existing file in 'write' mode overwrites any existing contents.

== Methods ==

If opened in 'write' mode, the following methods are available:

[[file.finalize]]

[[file.reopen]]

[[file.tofile]]

If opened in 'read' mode, these methods are available:

[[file.copy]]

[[file.finalize]]

[[file.readall]]

[[file.readnext]]

[[file.reopen]]

[[file.skip]]

== 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.

== See Also ==

* [[dofile]]

* [[openfile]]

* [http://www.easyuo.com/openeuo/wiki/index.php/Simplelib simplelib]

← Older revision		Revision as of 23:14, 18 December 2010
Line 17:		Line 17:

	[[file.tofile]]		[[file.tofile]]
		+
		+	[[file.streamout]]

	If opened in 'read' mode, these methods are available:		If opened in 'read' mode, these methods are available:

← Older revision		Revision as of 02:31, 25 November 2010
Line 31:		Line 31:

	[[file.skip]]		[[file.skip]]
		+
		+	[[file.stream]]

	== Usage Example ==		== Usage Example ==

@@ Line 6: / Line 6: @@
   b is a string, the mode, either 'read' or 'write'
 Results
-  f is a structured file object
+  f is a structured file handling object (not the same as a lua file object)
 == Usage Example ==

@@ Line 28: / Line 28: @@
 == 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.''
+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.''
 == Methods ==

@@ Line 8: / Line 8: @@
   f is a structured file handling object (not the same as a lua file object)
-== Usage Example ==
+== Object Methods ==
-−
- 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.,
-.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.''
-−
-== Methods ==
 If opened in 'write' mode, the following methods are available:
@@ Line 53: / Line 31: @@
 [[file.skip]]
 == Upon Error ==