svn: /phpdoc/en/trunk/reference/filesystem/functions/ file-get-contents.xml

From: 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>

« previous php.doc.cvs (#7678) next »