fgetc
Name
fgetc — Reads a character from a file.
Synopsis
string fgetc(file_handle);
resource file_handle:
Returns
Single character or FALSE
Description
Returns a single character from a file. If the location
of the file pointer is at EOF (end of file), FALSE is
returned.
fgetc() is quite inefficient and should not be
used to read large amounts of data. If you need to
process text from a file one character at a time, use
fgets() to read in
the data one line at a time and then process the line
one character at a time with a looping construct such
as while() or for() .
Because some of the filesystem functions to read/write
from files partially share the same code, one or more
of the bugs reported elsewhere may also apply to this
function.
3.0.6: Function not binary-safe.
3.0.9: Function may hang when used with sockets on
FreeBSD 3.2.
Example
Example 306. Read from a file
character by character
<?php
// Inefficient for large files!
$fh = fopen("test.txt", "r");
while (! feof ($fh)) {
echo fgetc ($fh);
}
fclose ($fh);
?>
PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing
(Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch).
This material may be distributed only subject to the terms and conditions set forth
in the Open Publication License, v1.0 or later (the latest version is presently available at
http://www.opencontent.org/openpub/).
The authors of this book have elected not to choose any options under the OPL. This online book was obtained
from
http://www.fooassociates.com/phpfer/
and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4
for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All
persons and entities shall have neither liability nor responsibility to any person or entity with respect to
any loss or damage arising from the information contained in this book.
PhpDig.net