pollita Wed Mar 31 22:57:39 2004 EDT
Modified files:
/phpdoc/en/reference/stream/functions stream-filter-prepend.xml
stream-filter-append.xml
Log:
Document how filters treat internal read buffer.
http://cvs.php.net/diff.php/phpdoc/en/reference/stream/functions/stream-filter-prepend.xml?r1=1.7&r2=1.8&ty=u
Index: phpdoc/en/reference/stream/functions/stream-filter-prepend.xml
diff -u phpdoc/en/reference/stream/functions/stream-filter-prepend.xml:1.7
phpdoc/en/reference/stream/functions/stream-filter-prepend.xml:1.8
--- phpdoc/en/reference/stream/functions/stream-filter-prepend.xml:1.7 Sat Sep 13
22:33:42 2003
+++ phpdoc/en/reference/stream/functions/stream-filter-prepend.xml Wed Mar 31
22:57:39 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
<refentry id="function.stream-filter-prepend">
<refnamediv>
<refname>stream_filter_prepend</refname>
@@ -45,6 +45,17 @@
in order to register the desired user filter to
<parameter>filtername</parameter>.
</simpara>
</note>
+ <note>
+ <simpara>
+ Stream data is read from resources (both local and remote) in chunks,
+ with any unconsumed data kept in internal buffers. When a new
+ filter is prepended to a stream, data in the internal buffers,
+ which has already been processed through other filters will
+ <emphasis>not</emphasis> be reprocessed through the new filter
+ at that time. This differs from the behavior of
+ <function>stream_filter_append</function>.
+ </simpara>
+ </note>
<simpara>
See also
<function>stream_filter_register</function>, and
http://cvs.php.net/diff.php/phpdoc/en/reference/stream/functions/stream-filter-append.xml?r1=1.9&r2=1.10&ty=u
Index: phpdoc/en/reference/stream/functions/stream-filter-append.xml
diff -u phpdoc/en/reference/stream/functions/stream-filter-append.xml:1.9
phpdoc/en/reference/stream/functions/stream-filter-append.xml:1.10
--- phpdoc/en/reference/stream/functions/stream-filter-append.xml:1.9 Mon Dec 15
11:53:49 2003
+++ phpdoc/en/reference/stream/functions/stream-filter-append.xml Wed Mar 31
22:57:39 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
<refentry id="function.stream-filter-append">
<refnamediv>
<refname>stream_filter_append</refname>
@@ -84,6 +84,15 @@
in order to register the desired user filter to
<parameter>filtername</parameter>.
</simpara>
</note>
+ <note>
+ <simpara>
+ Stream data is read from resources (both local and remote) in chunks,
+ with any unconsumed data kept in internal buffers. When a new
+ filter is appended to a stream, data in the internal buffers is processed
through
+ the new filter at that time. This differs from the behavior of
+ <function>stream_filter_prepend</function>.
+ </simpara>
+ </note>
<simpara>
See also
<function>stream_filter_register</function>, and
