fgetc

(PHP 4, PHP 5, PHP 7)

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

説明

fgetc ( resource $handle ) : string

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

パラメータ

handle

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

返り値

handleが指すファイルポインタから 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 行取得する