ftell(3S)
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, ftell() returns the current value of the file-position indicator for the stream measured in bytes from the beginning of the file.
Otherwise, it returns −1 and sets errno to indicate 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 an explicit 64-bit equivalent. See interface64(5).
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| MT-Level | MT-Safe |
SEE ALSO
lseek(2), fopen(3S), fseek(3S), attributes(5), interface64(5)
SunOS 5.6 — Last change: 4 Apr 1997