Content-type: text/html Man page of ftell

ftell

Section: Standard C Library Functions (3C)
Updated: 24 Jul 2002
Index Return to Main Contents
 

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() functions return the current value of the file-position indicator for the stream measured in bytes from the beginning of the file. Otherwise, they return -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 a transitional interface for 64-bit file offsets. See lf64(5).  

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface StabilityStandard
MT-Level MT-Safe

 

SEE ALSO

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
USAGE
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:24 GMT, October 02, 2010