FTELL(3) 1 FTELL(3)
ftell - Returns the current position of the file read/write pointer
SYNOPSIS
int ftell (resource $handle)
DESCRIPTION
Returns the position of the file pointer referenced by $handle.
PARAMETERS
o $handle
- The file pointer must be valid, and must point to a file successfully opened by fopen(3) or popen(3). ftell(3) gives undefined
results for append-only streams (opened with "a" flag).
RETURN VALUES
Returns the position of the file pointer referenced by $handle 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.
EXAMPLES
Example #1
ftell(3) 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(3), popen(3), fseek(3), rewind(3).
PHP Documentation Group FTELL(3)
