# ftell

(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()