Standard C Library Functions                            ftell(3C)



NAME
     ftell, ftello - return a file offset in a stream

SYNOPSIS
     #include 

     long ftell(FILE *stream);


     offt ftello(FILE *stream);


DESCRIPTION
     The ftell() function obtains the current value of the  file-
     position  indicator for the stream pointed to by stream. The
     ftello() function is identical to  ftell()  except  for  the
     return type.

RETURN VALUES
     Upon successful completion, the ftell() and  ftello()  func-
     tions  return the current value of the file-position indica-
     tor for the stream measured in bytes from the  beginning  of
     the  file. Otherwise, they return -1 and sets errno to indi-
     cate the error.

ERORS
     The ftell() and ftello() functions will fail if:

     EBADF     The file descriptor underlying stream  is  not  an
               open file descriptor.


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



     The ftell() function will fail if:

     EOVERFLOW    The current file offset cannot  be  represented
                  correctly in an object of type long.



     The ftello() function will fail if:

     EOVERFLOW    The current file offset cannot  be  represented
                  correctly in an object of type offt.


USAGE




SunOS 5.11          Last change: 24 Jul 2002                    1






Standard C Library Functions                            ftell(3C)



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

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



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


SEE ALSO
     lseek(2),  fopen(3C),  fseek(3C),  attributes(5),  ,   stan-
     dards(5), lf64(5)


































SunOS 5.11          Last change: 24 Jul 2002                    2