Standard C Library Functions                            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:

SunOS 5.8           Last change: 28 Jan 1998                    1

Standard C Library Functions                            ftell(3C)

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

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

SunOS 5.8           Last change: 28 Jan 1998                    2