Manual Pages for UNIX Operating System command usage for man ftell

Standard C Library Functions                            ftell(3C)



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

SYNOPSIS
     #include 

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


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

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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


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
































SunOS 5.11          Last change: 24 Jul 2002                    2