streamWrapper::stream_read

streamWrapper::stream_read

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

streamWrapper::stream_read - 从流中读取

描述

public string streamWrapper::stream_read ( int $count )

这个方法是为了响应fread()和fgets()而调用的。

注意：请记住更新流的读/写位置（通过成功读取的字节数）。

参数

count

应该返回当前位置的数据字节数。

返回值

如果少于count可用字节数，则返回尽可能多的字节。如果没有更多数据可用，则返回一个FALSE或一个空字符串。

错误/异常

如果对此方法的调用失败（即未实现），则发出E_WARNING。

注意：如果返回值较长，则会count发出E_WARNING错误，并且超出的数据将会丢失。

注意

注意：在调用streamWrapper::stream_read()来检查EOF是否已经到达之后，直接调用streamWrapper::stream_eof()。如果不实施，则假定EOF。

警告

当读取整个文件时（例如，使用file_get_contents()），PHP将在循环中调用streamWrapper::stream_read()，接着调用streamWrapper::stream_eof()，但只要streamWrapper::stream_read()返回一个非空字符串，streamWrapper::stream_eof()的返回值被忽略。

另请参阅

• fread() - 读取二进制安全文件

• fgets() - 从文件指针获取行

← streamWrapper::stream_open

streamWrapper::stream_seek →