streamWrapper::stream_read
(PHP 4 >= 4.3.2, PHP 5, PHP 7)
streamWrapper::stream_read — ストリームから読み込む
説明
$count
)このメソッドは、fread() および fgets() に対応してコールされます。
注意:
ストリームの読み込み/書き込み位置 (読み込みに成功したバイト数ぶん) の更新を忘れないようにしましょう。
パラメータ
-
count -
現在位置から何バイトぶんのデータを返すか。
返り値
count バイト未満のデータしか存在しない場合は、
返せる限りのデータを返します。もうデータがない場合は、
FALSE あるいは空文字列を返します。
エラー / 例外
このメソッドのコールに
(未実装などの理由で) 失敗した場合、
E_WARNING を発行します。
注意:
返り値が
countより長い場合はE_WARNINGエラーが発生し、余分なデータは失われます。
注意
注意:
streamWrapper::stream_eof() は、 streamWrapper::stream_read() がコールされた後に直接コールされ、 EOF に達したかどうかを調べます。実装されていない場合は EOF だとみなされます。
ファイル全体を (file_get_contents() などで) 読み込む場合、PHP はループ内で streamWrapper::stream_read() をコールしてから streamWrapper::stream_eof() をコールします。 しかし、streamWrapper::stream_read() が空でない文字列を返す限りは streamWrapper::stream_eof() の返り値を無視します。
忘却曲線を使ってこの知識を確実に記憶に残す
