int fgetpos( FILE *fp, fpos_t *pos )

FILE   *fp;       /* input stream pointer */

fpos_t *pos;      /* structure to hold file position information */

Synopsis

#include "stdio.h"

The fgetpos function retrieves the current position from fp and stores it into the structure pointed to by pos . This value may be subsequently used by fsetpos .

Parameters

fp is an open file stream. pos is the address of a file position structure (fpos_t is defined in stdio.h).

Return Value

fgetpos returns 0 if successful, and a non-zero value if not.

The fpos_t type is provided for recording file positions, where the possible length of the file is too large to be represented in a long integer.

See Also

fsetpos