Php/docs/function.fgetc

From Get docs

fgetc

(PHP 4, PHP 5, PHP 7)

fgetcGets character from file pointer


Description

fgetc ( resource $handle ) : string

Gets a character from the given file pointer.


Parameters

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


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() example

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

Notes

Note:

This function is

binary-safe.

See Also

  • fread() - Binary-safe file read
  • fopen() - Opens file or URL
  • popen() - Opens process file pointer
  • fsockopen() - Open Internet or Unix domain socket connection
  • fgets() - Gets line from file pointer