php man page for ftell

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)