svn: /phpdoc/en/trunk/reference/rar/ functions/rar-close.xml rarentry/getstream.xml

cataphract Sat, 21 Nov 2009 02:15:16 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=291105 Log: Made clear that calling rar_close invalidates RarEntry objects but not streams obtained through RarEntry::getstream.xml(). Changed paths: U phpdoc/en/trunk/reference/rar/functions/rar-close.xml U phpdoc/en/trunk/reference/rar/rarentry/getstream.xml Modified: phpdoc/en/trunk/reference/rar/functions/rar-close.xml =================================================================== --- phpdoc/en/trunk/reference/rar/functions/rar-close.xml 2009-11-21 01:22:32 UTC (rev 291104) +++ phpdoc/en/trunk/reference/rar/functions/rar-close.xml 2009-11-21 02:15:16 UTC (rev 291105) @@ -39,6 +39,32 @@ &return.success; </para> </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>2.0.0</entry> + <entry> + The Rar entries returned by <function>rar_entry_get</function> + and <function>rar_list</function> are now invalidated when + calling <function>rar_close</function>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> </refentry> Modified: phpdoc/en/trunk/reference/rar/rarentry/getstream.xml =================================================================== --- phpdoc/en/trunk/reference/rar/rarentry/getstream.xml 2009-11-21 01:22:32 UTC (rev 291104) +++ phpdoc/en/trunk/reference/rar/rarentry/getstream.xml 2009-11-21 02:15:16 UTC (rev 291105) @@ -20,6 +20,10 @@ supports read operations. This handler provides on-the-fly decompression for this entry. </para> + <para> + The handler is not invalidated by calling + <function>rar_close</function>. + </para> </refsect1> <refsect1 role="returnvalues"> @@ -49,6 +53,8 @@ $stream = $entry->getStream(); if ($stream === false) die("Failed to obtain stream."); + +rar_close($rar_file); //stream is independent from file while (!feof($stream)) { $buff = fread($stream, 8192); @@ -58,6 +64,8 @@ break; //fread error } +fclose($stream); + ?> ]]> </programlisting>