ftell

(PHP 3, PHP 4, PHP 5)

ftell -- Tells file pointer read/write position

Description

int ftell ( resource handle )

Tells the file pointer read/write position.

Parameters

handle

The file pointer must be valid, and must point to a file successfully opened by fopen() or popen(). ftell() gives undefined results for append-only streams (opened with "a" flag).

Return Values

Returns the position of the file pointer referenced by handle; i.e., its offset into the file stream.

If an error occurs, returns FALSE.

Examples

Example 1. ftell() example

<?php

// opens a file and read some data
$fp = fopen("/etc/passwd", "r");
$data = fgets($fp, 12);

// where are we ?
echo ftell($fp); // 11

fclose($fp);

?>

See Also

fopen()
popen()
fseek()
rewind()