programming.nbk: Home | Index | Next Page: fstat() | Previous Page: fread()

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

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.

programming.nbk: Home | Index | Next Page: fstat() | Previous Page: fread()

Notebook exported on Monday, 7 July 2008, 18:56:06 PM Eastern Daylight Time