fgetc(3) [php man page]

FGETC(3)								 1								  FGETC(3)

fgetc - Gets character from file pointer

SYNOPSIS

       string fgetc (resource  $handle)

DESCRIPTION

	Gets a character from the given file pointer.

PARAMETERS

	      o $handle
		-The  file  pointer must be valid, and must point to a file successfully opened by fopen(3) or fsockopen(3) (and not yet closed by
		fclose(3)).

RETURN VALUES

	Returns a string containing a single character read from the file pointed to by $handle. Returns FALSE on EOF.

       Warning

	      This function may return Boolean FALSE, but may also return a non-Boolean value which evaluates to FALSE. Please read the section on
	      Booleans for more information. Use the === operator for testing the return value of this function.

EXAMPLES

       Example #1

	      A fgetc(3) example

	      <?php
	      $fp = fopen('somefile.txt', 'r');
	      if (!$fp) {
		  echo 'Could not open file somefile.txt';
	      }
	      while (false !== ($char = fgetc($fp))) {
		  echo "$char
";
	      }
	      ?>

NOTES

       Note

	      This function is binary-safe.

SEE ALSO

       fread(3), fopen(3), popen(3), fsockopen(3), fgets(3).

PHP Documentation Group 														  FGETC(3)

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)