Difference between revisions of "File.skip"
From OpenEUO
(Created page with "== Calling Pattern == Call local f = sl.file(a,'read') later: local r = f.skip(n) Arguments n is a number Results r is of value EOF, nil, or true == Example Usage == h =...") |
(killspam) |
| (5 intermediate revisions by 5 users not shown) | |
(No difference)
| |
Latest revision as of 18:32, 15 July 2012
Calling Pattern
Call
local f = sl.file(a,'read')
later:
local r = f.skip(n)
Arguments
n is a number
Results
r is of value EOF, nil, or true
Example Usage
h = sl.file(getinstalldir()..'scripts/testread.dat', 'read')
local j = h.skip(4) -- skip first four stored values
print(tostring(j))
local val = true
while val ~= nil and val ~= 'EOF' do
val = h.readnext()
if val == sl.null then val = 'null' end
if val == sl.EOF then val = 'EOF' end
print('val : '..tostring(val))
end
--> true
val : 30
val : TEST_
val : true
val : false
val : null
val : true
val : 3.141622e-030
val : table: 0x011da540
val : EOF
Description
Skip jumps over the number of stored values specified by argument n. A positive n seeks from the current read location towards the end of the file, and negative n seeks towards the beginning of the file. If either the beginning or the end of the file is reached, EOF is returned.
Upon Error
Skip returns nil if there is a problem seeking over the file.
