Home  Contents

rawio:seek

Rawio Core4 Lua Event System

SYNOPSIS

#include <lua/unistd.lh>
  1. offset = handle:seek(offset, whence)
  2. offset = handle:tell()

DESCRIPTION

rawio:seek() moves the offset of the file pointer according to the directive whence as follows:

SEEK_SET or "set" The offset is set to offset bytes.
SEEK_CUR or "cur" The offset is set to the current location plus offset bytes.
SEEK_END or "end" The offset is set to the length of the file plus offset bytes.

rawio:tell() is used to read the current file position. It is synonymous to rawio:seek(0, SEEK_CUR).

RETURN VALUE

On success, returns the file offset after the command has completed. On failure, returns nil. In case of an error, the error can be retrieved using rawio:lastError().

EXAMPLE

>  >  >  >  >  > 
handle = rawio.open("/tmp/test.txt", rawio.rdwr | rawio.creat) print(handle:tell()) handle:write("HUllo World!") print(handle:seek(1, "set")) handle:write("e") print(handle:tell())
0 1 2

SEE ALSO