stream_get_contents
(PHP 5)
stream_get_contents — Reads remainder of a stream into a string
说明
string stream_get_contents ( resource $handle [, int $maxlength = -1 [, int $offset = -1 ]] )Identical to file_get_contents(), except that stream_get_contents() operates on an already open stream resource and returns the remaining contents in a string, up to maxlength bytes and starting at the specified offset.
参数
- handle (resource)
-
A stream resource (e.g. returned from fopen())
- maxlength (integer)
-
The maximum bytes to read. Defaults to -1 (read all the remaining buffer).
- offset (integer)
-
Seek to the specified offset before reading. If this number is negative, no seeking will occur and reading will start from the current position.
返回值
Returns a string 或者在失败时返回 FALSE.
更新日志
| 版本 | 说明 |
|---|---|
| 5.1.0 | The offset was added. |
范例
Example #1 stream_get_contents() example
<?php
if ($stream = fopen('http://www.example.com', 'r')) {
// print all the page starting at the offset 10
echo stream_get_contents($stream, -1, 10);
fclose($stream);
}
if ($stream = fopen('http://www.example.net', 'r')) {
// print the first 5 bytes
echo stream_get_contents($stream, 5);
fclose($stream);
}
?>
注释
Note: 此函数可安全用于二进制对象。
参见
- fgets() - 从文件指针中读取一行
- fread() - 读取文件（可安全用于二进制文件）
- fpassthru() - 输出文件指针处的所有剩余数据
