トップページ　→関数リファレンス　→その他の基本モジュール　→ストリーム　→streamWrapper

関数・クラス解説

streamWrapper::stream_read

version:PHP 4 >= 4.3.2, PHP 5, PHP 7 (公式)

ストリームから読み込む

公式リファレンス

書式

public streamWrapper::stream_read ( int $count ) : string

説明

このメソッドは、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() の返り値を無視します。警告ファイル全体を (file_get_contents() などで) 読み込む場合、PHP はループ内で streamWrapper::stream_read() をコールしてから streamWrapper::stream_eof() をコールします。しかし、streamWrapper::stream_read() が空でない文字列を返す限りは streamWrapper::stream_eof() の返り値を無視します。