fseek

Syntax

#include <stdio.h>

int fseek(FILE *file, long offset, int mode);

Description

This function moves the file pointer for file according to mode:

SEEK_SET

The file pointer is moved to the offset specified.

SEEK_CUR

The file pointer is moved relative to its current position.

SEEK_END

The file pointer is moved to a position offset bytes from the end of the file. The offset is usually nonpositive in this case.

Warning! The ANSI standard only allows values of zero for offset when whence is not SEEK_SET and the file has been opened as a text file. Although this restriction is not enforced, beware that there is not a one-to-one correspondence between file characters and text characters under MS-DOS, so some fseek operations may not do exactly what you expect.

Return Value

Zero if successful, nonzero if not.

Example

fseek(stdin, 12, SEEK_CUR); /* skip 12 bytes */

Go to the first, previous, next, last section, table of contents.