Syntax

int fseek( FILE * stream , long offset , int origin )

Description

Reposition stream's position indicator. Sets the position indicator associated with the stream to a new position defined by an offset from the location given by the origin parameter.

The End-Of-File indicator of this stream is cleared after a call to fseek.

When using fseek on files opened in text mode consider that you can only be sure of the results if an offset of 0 or an offset equal to a value returned from ftell is specified, any other offset value makes result unpredictable because of Carriage-Return translations under this mode.

The next operation with the stream after a call to fseek can be either for input or output.

Parameters

• stream Pointer to an open file.
• offset Number of bytes from origin.
• origin Initial position from where offset is applied. It can be any of these constants defined in stdio.h:
  • SEEK_SET (0) Beginning of file.
  • SEEK_CUR (1) Current position of the file pointer.
  • SEEK_END (2) End of file.

Return Value

If successful the function returns 0. Otherwise it returns nonzero.