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() 后立即被调用,以检查是否已到达文件末尾。如果未实现,则假设已到达文件末尾。

警告

当读取整个文件时(例如,使用 file_get_contents()),PHP 会循环调用 streamWrapper::stream_read(),然后调用 streamWrapper::stream_eof(),但只要 streamWrapper::stream_read() 返回一个非空字符串,streamWrapper::stream_eof() 的返回值就会被忽略。

参见

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

添加注释

用户贡献的注释

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