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)