ftell(3C)




NAME

     ftell, ftello - return a file offset in a stream


SYNOPSIS

     #include <stdio.h>

     long ftell(FILE *stream);

     off_t 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.


ERRORS

     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  associated
           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 off_t.


USAGE

     The ftello() 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), fopen(3C), fseek(3C), attributes(5), lf64(5)


Man(1) output converted with man2html