Standard C Library Functions                          fsetpos(3C)



NAME
     fsetpos - reposition a file pointer in a stream

SYNOPSIS
     #include 

     int fsetpos(FILE *stream, const fpost *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.

ERORS
     The fsetpos() function may fail if:

     EBADF     The  file  descriptor  underlying  stream  is  not
               valid.


     ESPIPE    The file descriptor underlying stream  is  associ-
               ated with a pipe, a FIFO, or a socket.


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

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










SunOS 5.11          Last change: 24 Jul 2002                    1






Standard C Library Functions                          fsetpos(3C)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


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











































SunOS 5.11          Last change: 24 Jul 2002                    2