Gets a stream's file pointer position-indicator and stores it. This function does not get the file pointer; use ftell instead.

#include <stdio.h>

int fgetpos (FILE *stream, fpos_t *pos);

Parameters

stream

Pointer to FILE structure.

pos

File pointer position-indicator storage.

Remarks

The file pointer position-indicator value is stored in fpos_t format, which is used only by fgetpos and fsetpos. fsetpos can use information stored in pos to reset the file pointer for stream to its position at the time fgetpos was called.

Return Values

0 (zero).

Success.

Any other value; the function sets errno to one of these values:

EBADF	The specified stream is not a valid file descriptor or is not accessible.
EINVAL	The stream value is invalid.

Failure.

Requirements

See Also

ftell, fsetpos