MTA:Eir/FileSystem/file/tell: Difference between revisions
Jump to navigation
Jump to search
(Created page with "__NOTOC__ This function returns the current absolute position inside of the file/stream object. It should be the number of bytes that the current stream pointer is set from the b...") |
No edit summary |
||
| Line 4: | Line 4: | ||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
int file | int file:tell () | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 16: | Line 16: | ||
local function alternativeFileReset( theFile ) | local function alternativeFileReset( theFile ) | ||
-- Get the current stream position. | -- Get the current stream position. | ||
local streamOffset = theFile | local streamOffset = theFile:tell(); | ||
-- Check whether this operation is supported. | -- Check whether this operation is supported. | ||
| Line 24: | Line 24: | ||
-- Reset the file to its beginning. | -- Reset the file to its beginning. | ||
theFile | theFile:seek( -streamOffset, "cur" ); | ||
return true; | return true; | ||
end | end | ||
Latest revision as of 23:48, 16 January 2022
This function returns the current absolute position inside of the file/stream object. It should be the number of bytes that the current stream pointer is set from the beginning of the object. Not all stream classes have to support this operation.
Syntax
int file:tell ()
Returns
Returns the amount of bytes that this file/stream object has already traversed. If the operation is not supported by the underlying stream class, it returns false.
Example
Click to collapse [-]
ClientThis snippet seeks back to the beginning of the file by going back the current stream pointer byte offset.
local function alternativeFileReset( theFile )
-- Get the current stream position.
local streamOffset = theFile:tell();
-- Check whether this operation is supported.
if not ( streamOffset ) then
return false, "not supported";
end
-- Reset the file to its beginning.
theFile:seek( -streamOffset, "cur" );
return true;
end