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