svn: /phpdoc/en/trunk/reference/filesystem/functions/ file-get-contents.xml
| From: | Philip Olson | Date: | Wed, 26 Jan 2011 20:38:28 +0000 |
| Subject: | svn: /phpdoc/en/trunk/reference/filesystem/functions/ file-get-contents.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-7678@lists.php.net to get a copy of this message | ||
philip Wed, 26 Jan 2011 20:38:28 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=307767
Log:
- Document that the offset parameter does not work with remote files
- Mentioned when file_get_contents() emits E_WARNING errors
- Closes PHP Bug #53790
- Deals with PHP Bug #46043
Bugs: http://bugs.php.net/53790 (Open) about
"file_get_contents()"
http://bugs.php.net/46043 (Bogus) file_get_contents()
gives "stream does not support seeking" error with offset
Changed paths:
U phpdoc/en/trunk/reference/filesystem/functions/file-get-contents.xml
Modified: phpdoc/en/trunk/reference/filesystem/functions/file-get-contents.xml
===================================================================
--- phpdoc/en/trunk/reference/filesystem/functions/file-get-contents.xml 2011-01-26 18:38:44 UTC
(rev 307766)
+++ phpdoc/en/trunk/reference/filesystem/functions/file-get-contents.xml 2011-01-26 20:38:28 UTC
(rev 307767)
@@ -130,6 +130,11 @@
<para>
The offset where the reading starts on the original stream.
</para>
+ <para>
+ Seeking (<parameter>offset</parameter>) is not supported with remote files.
+ Attempting to seek on non-local files may work with small offsets, but this
+ is unpredictable because it works on the the buffered stream.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
@@ -153,6 +158,14 @@
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ <para>
+ An <constant>E_WARNING</constant> level error is generated if either
<parameter>maxlength</parameter>
+ is less than zero, or if <parameter>offset</parameter> exceeds the length of the
stream.
+ </para>
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>