FSETPOS(3S)                                                        FSETPOS(3S)


NAME
     fsetpos, fsetpos64, fgetpos, fgetpos64 - reposition a file pointer in a
     stream

SYNOPSIS
     #include <stdio.h>

     int fsetpos (FILE *stream, const fpos_t *pos);

     int fsetpos64 (FILE *stream, const fpos64_t *pos);

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

     int fgetpos64 (FILE *stream, fpos64_t *pos);

DESCRIPTION
     Fsetpos and fgetpos save and restore the file position indicated by the
     value of the object pointed at by pos.

     The functions fsetpos64 and fgetpos64 are identical to fsetpos and
     fgetpos respectively, except that they take an fpos64_t * as an argument.
     This allows for the specification of a file position that is greater that
     2 Gigabytes.

     A call to fgetpos stores the current value of the file position indicator
     for stream in the object pointed at by pos.  The information is encoded
     in a format which may only be usable by fsetpos for the repositioning the
     stream to its position at the time of the call to fgetpos.

     Fsetpos restores the file position of the stream to the value encoded in
     the object pointed at by pos, which must have been set by a previous call
     to fgetpos on the same stream.  A successful call to fsetpos clears the
     end-of-file indicator for the stream and undoes any effect of the
     ungetc(3S) function on it.  After a call to fsetpos, the next operation
     on an update stream may be either input or output.

SEE ALSO
     lseek(2), fseek(3s), fopen(3S), popen(3S), stdio(3S), ungetc(3S).

DIAGNOSTICS
     If successful, both fsetpos and fgetpos return zero.  On failure, they
     return non-zero and set errno to indicate the error.


                                                                        Page 1