fgets

fgets -- ファイルポインタから 1 行取り出す

説明

string fgets(int fp, int length);

fp で指定されたファイルポインタから最大 length - 1 バイト読み出し、 その文字列を返します。読み出しは、length - 1 バイト読み出したか、(返り値に含まれる)改行文字を検出したか、 EOF に達したかのいずれかが起こった時点で終了します。

エラーが起こった場合 FALSE を返します。 陥りやすい罠:

fgets の 'C' と同義に使用する者は、EOFを返す条件の違いについて 注意する必要があります。

ファイルポインタは有効なものでなければならず、また fopen, popen またはfsockopen で正常にオープンされたファイルを指している必要があります。

簡単な例を以下に示します。

例 1. 行毎にファイルを読み込む


$fd = fopen("/tmp/inputfile.txt", "r");
while (!feof($fd)) {
  $buffer = fgets($fd, 4096);
  echo $buffer;
}
fclose($fd);

参照:fread, fopen, popen, fgetc, fsockopen