fgetc

(PHP 4, PHP 5, PHP 7, PHP 8)

fgetc — ファイルポインタから1文字取り出す

説明

fgetc(resource $stream): string|false

指定したファイルポインタから 1 文字読み出します。

パラメータ

stream: ファイルポインタは、有効なファイルポインタである必要があり、 fopen() または fsockopen() で正常にオープンされた（そしてまだ fclose() でクローズされていない）ファイルを指している必要があります。

戻り値

streamが指すファイルポインタから 1 文字読み出し、その文字からなる文字列を返します。EOF の場合に false を返します。

警告

この関数は論理値 false を返す可能性がありますが、false として評価される値を返す可能性もあります。詳細については論理値のセクションを参照してください。この関数の返り値を調べるには ===演算子を使用してください。

例

例1 fgetc() の例

<?php
$fp = fopen('somefile.txt', 'r');
if (!$fp) {
    echo 'somefile.txt をオープンできませんでした';
}
while (false !== ($char = fgetc($fp))) {
    echo "$char\n";
}
?>

注意

注意: この関数はバイナリデータに対応しています。

参考

fread() - バイナリセーフなファイルの読み込み
fopen() - ファイルまたは URL をオープンする
popen() - プロセスへのファイルポインタをオープンする
fsockopen() - インターネット接続もしくは Unix ドメインソケット接続をオープンする
fgets() - ファイルポインタから 1 行取得する