Return the current file position indicator value.

This function is compatible with the following targets:

ANSI

BeOS

EMB/RTOS

Mac OS

Palm OS

Win32

#include <stdio.h>

long int ftell(FILE *stream);

Parameters for this facility are:

stream

FILE *

A pointer to a FILE stream

The ftell() function returns the current value of stream's file position indicator. It is used in conjunction with fseek() to provide random access to a file.

The function will not work correctly when it is given a stream associated to a console file, such as stdin, stdout, or stderr, where a file indicator position is not applicable. Also, ftell() cannot handle files with sizes larger than what can be represented with a long int. In such a case, use the fgetpos() and fsetpos() functions.

ftell(), when successful, returns the current file position indicator value. If it fails, ftell() returns -1L and sets the global variable errno to a nonzero value.

"errno," "fgetpos"

Refer to "Example of fseek() usage." for fseek().