array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'streamwrapper.stream-read.php', 1 => 'streamWrapper::stream_read', 2 => 'ストリームから読み込む', ), 'up' => array ( 0 => 'class.streamwrapper.php', 1 => 'streamWrapper', ), 'prev' => array ( 0 => 'streamwrapper.stream-open.php', 1 => 'streamWrapper::stream_open', ), 'next' => array ( 0 => 'streamwrapper.stream-seek.php', 1 => 'streamWrapper::stream_seek', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/stream/streamwrapper/stream-read.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

streamWrapper::stream_read

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

streamWrapper::stream_read — ストリームから読み込む

説明

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

このメソッドは、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() の戻り値を無視します。

参考