PHP Conference Japan 2024

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() 的返回值就会被忽略。

参见

  • fread() - 二进制安全文件读取
  • fgets() - 从文件指针获取行

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top