Standard C Library Functions                          fgetpos(3C)



NAME
     fgetpos - get current file position information

SYNOPSIS
     #include 

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


DESCRIPTION
     The fgetpos() function stores the current value of the  file
     position  indicator  for  the stream pointed to by stream in
     the object pointed to by  pos.  The  value  stored  contains
     unspecified  information  usable  by fsetpos(3C) for reposi-
     tioning the stream to its position at the time of  the  call
     to fgetpos().

RETURN VALUES
     Upon successful completion, fgetpos() returns 0.  Otherwise,
     it  returns  a non-zero value and sets errno to indicate the
     error.

ERORS
     The fgetpos() function may fail if:

     EBADF        The file descriptor underlying  stream  is  not
                  valid.


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


     EOVERFLOW    The current value of the file  position  cannot
                  be  represented  correctly in an object of type
                  fpost.


USAGE
     The fgetpos() 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                          fgetpos(3C)



     
     ATRIBUTE TYPE               ATRIBUTE VALUE             
    
     Interface Stability          Standard                    
    


SEE ALSO
     fopen(3C), fsetpos(3C), ftell(3C),  rewind(3C),  ungetc(3C),
     attributes(5), lf64(5), standards(5)













































SunOS 5.11          Last change: 24 Jul 2002                    2