FSEEK(3)

NAME
fseek, fseeko, ftell, ftello, rewind - reposition a stream

SYNOPSIS
#include <stdio.h>
int fseek(FILE *stream, long offset, int ptrname)
int fseeko(FILE *stream, off_t offset, int ptrname)
long ftell(FILE *stream)
off_t ftello(FILE *stream)
void rewind(FILE *stream)

DESCRIPTION
Fseek and fseeko set the position of the next input or output operation on the stream. The new position is at the signed distance offset bytes from the beginning, the current position, or the end of the file, according as ptrname has the value 0, 1, or 2.

Fseek and fseeko undo any effects of ungetc(3).

Ftell and ftello return the current value of the offset relative to the beginning of the file associated with the named stream. It is measured in bytes on UNIX; on some other systems it is a magic cookie, and the only foolproof way to obtain an offset for fseek and fseeko.

Rewind(stream) is equivalent to fseek(stream, 0L, 0).

SEE ALSO
lseek(2), fopen(3).

DIAGNOSTICS
Fseek and fseeko return -1 for improper seeks, otherwise zero.