[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions fgets.xml From: Wez Furlong (wez.php <email protected>)
Date: 10/19/02

wez Sat Oct 19 09:25:47 2002 EDT

  Modified files:
    /phpdoc/en/reference/filesystem/functions fgets.xml
  Log:
  Document binary safety for fgets.
  
  
Index: phpdoc/en/reference/filesystem/functions/fgets.xml
diff -u phpdoc/en/reference/filesystem/functions/fgets.xml:1.3 phpdoc/en/reference/filesystem/functions/fgets.xml:1.4
--- phpdoc/en/reference/filesystem/functions/fgets.xml:1.3 Thu Sep 26 09:59:33 2002
+++ phpdoc/en/reference/filesystem/functions/fgets.xml Sat Oct 19 09:25:47 2002
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.fgets">
    <refnamediv>
@@ -54,7 +54,19 @@
     </para>
     <note>
      <simpara>
- The <parameter>length</parameter> parameter became optional in PHP 4.2.0
+ The <parameter>length</parameter> parameter became optional in PHP
+ 4.2.0, if omitted, it would assume 1024 as the line length.
+ As of PHP 4.3, omitting <parameter>length</parameter> will keep
+ reading from the stream until it reaches the end of the line.
+ If the majority of the lines in the file are all larger than 8KB,
+ it is more resource efficient for your script to specify the maximum
+ line length.
+ </simpara>
+ </note>
+ <note>
+ <simpara>
+ This function is binary safe as of PHP 4.3. Earlier versions
+ were not binary safe.
      </simpara>
     </note>
     &note.line-endings; 

-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php