streamWrapper::stream_read

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

streamWrapper::stream_read — Read from stream

说明

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

This method is called in response to fread() and fgets().

注意:

Remember to update the read/write position of the stream (by the number of bytes that were successfully read).

参数

count

How many bytes of data from the current position should be returned.

返回值

If there are less than count bytes available, as many as are available should be returned. If no more data is available, an empty string should be returned. To signal that reading failed, false should be returned.

错误／异常

调用此方法失败将给出 E_WARNING（未实现）。

注意:

If the return value is longer then count an E_WARNING error will be emitted, and excess data will be lost.

注释

注意:

streamWrapper::stream_eof() is called directly after calling streamWrapper::stream_read() to check if EOF has been reached. If not implemented, EOF is assumed.

警告

When reading the whole file (for example, with file_get_contents()), PHP will call streamWrapper::stream_read() followed by streamWrapper::stream_eof() in a loop but as long as streamWrapper::stream_read() returns a non-empty string, the return value of streamWrapper::stream_eof() is ignored.

参见

  • fread() - 读取文件（可安全用于二进制文件）
  • fgets() - 从文件指针中读取一行

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误
＋添加备注

用户贡献的备注

此页面尚无用户贡献的备注。

备份地址：http://www.lvesu.com/blog/php/streamwrapper.stream-read.php