Difference between revisions of "File:Seek"
From GiderosMobile
| Line 15: | Line 15: | ||
(number) = file:seek(whence,offset) | (number) = file:seek(whence,offset) | ||
</source> | </source> | ||
| + | === Parameters === | ||
'''whence''': (string) setting the base point for offset '''optional'''<br/> | '''whence''': (string) setting the base point for offset '''optional'''<br/> | ||
'''offset''': (number) offset to set position to '''optional'''<br/> | '''offset''': (number) offset to set position to '''optional'''<br/> | ||
| + | === Return values === | ||
'''Returns''' (number) the position in file measured in bytes from the beginning of the file<br/> | '''Returns''' (number) the position in file measured in bytes from the beginning of the file<br/> | ||
Revision as of 10:45, 23 August 2018
Available since: Gideros 2011.6
Description
Sets and gets the file position, measured from the beginning of the file, to the position given by offset plus a base specified by the string whence, as follows:
"set": base is position 0 (beginning of the file); "cur": base is current position; "end": base is end of file;
In case of success, function seek returns the final file position, measured in bytes from the beginning of the file. If this function fails, it returns nil, plus a string describing the error.
The default value for whence is "cur", and for offset is 0. Therefore, the call file:seek() returns the current file position, without changing it; the call file:seek("set") sets the position to the beginning of the file (and returns 0); and the call file:seek("end") sets the position to the end of the file, and returns its size.
(number) = file:seek(whence,offset)
Parameters
whence: (string) setting the base point for offset optional
offset: (number) offset to set position to optional
Return values
Returns (number) the position in file measured in bytes from the beginning of the file
File usage
There are no pages that use this file.
