seek

Builtin index · File I/O

seek(f, offset, [whence="start"])

Input: f, offset, whence · Output: no output

What it is

Moves f's (file handle, opened readable) read cursor. offset (number, byte count) is the distance to move. whence (string, optional, default "start") is "start", "current", or "end", matching C's fseek — the point offset is measured from.

Overloads

One call shape — this function is not overloaded.

Code	Input	Output	Description
`seek(f, offset, [whence="start"])`	`f` —Moves `f`'s (file handle, opened readable) read cursor. `offset` number`offset` (number, byte count) is the distance to move. `whence` string, optional (default `"start"`)`whence` (string, optional, default `"start"`) is `"start"`, `"current"`, or `"end"`, matching C's `fseek` — the point `offset` is measured from.	no output	—

Examples

No documentation example calls this form yet. The File I/O chapter is where one belongs.