fsetpos(3C)

NAME

     fsetpos - reposition a file pointer in a stream

SYNOPSIS

     #include <stdio.h>

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

DESCRIPTION

     The fsetpos() function sets the file position indicator  for
     the  stream  pointed  to by stream according to the value of
     the object pointed to by pos, which must be a value obtained
     from an earlier call to fgetpos(3C) on the same stream.

     A successful call to fsetpos() function clears  the  end-of-
     file  indicator  for  the  stream  and undoes any effects of
     ungetc(3C) on the same stream.  After an fsetpos() call, the
     next  operation  on  an update stream may be either input or
     output.

RETURN VALUES

     The fsetpos() function returns 0 if it  succeeds;  otherwise
     it  returns  a non-zero value and sets errno to indicate the
     error.

ERRORS

     The fsetpos() function may fail if:

     EBADF The file descriptor underlying stream is not valid.

     ESPIPE
           The file descriptor underlying  stream  is  associated
           with a pipe, a FIFO, or a socket.

USAGE

     The fsetpos() function has a transitional interface for  64-
     bit file offsets.  See lf64(5).

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|

SEE ALSO

     lseek(2),  fgetpos(3C),  fopen(3C),  fseek(3C),   ftell(3C),
     rewind(3C), ungetc(3C), attributes(5), lf64(5)