Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Standard C Library Functionsftell(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() 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
MT-LevelMT-Safe

SEE ALSO

 

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


SunOS 5.9Go To TopLast Changed 28 Jan 1998

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.