ftell()
ftell() — Returns the current position of the file read/write pointer.
Built-in function of PHP 8.5. The manual lists it as available in PHP 4, PHP 5, PHP 7, PHP 8. This page is the reference card: signature, parameters and return value, plus the changelog and the example the manual provides.
Signature
ftell(resource $stream): int|false
Parameters
| Parameter | Type | What it takes |
|---|---|---|
| $stream | resource | 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 value
Returns the position of the file pointer referenced by stream as an integer; i.e., its offset into the file stream. If an error occurs, returns false. Note: Because PHP's integer type is signed and many platforms use 32bit integers, some filesystem functions may return unexpected results for files which are larger than 2GB. Because PHP's integer type is signed and many platforms use 32bit integers, some filesystem functions may return unexpected results for files which are larger than 2GB.
Example
A runnable snippet:
// 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()
All PHP 8.5 built-in functions
Reference card built from the PHP manual page ftell() (PHP documentation, CC BY 3.0). The page is generated from the manual, so the wording of the parameter and return value text follows php.net.