vrana Wed Apr 5 16:20:05 2006 UTC
Modified files: /phpdoc/en/reference/filesystem/functions fgets.xml Log: Describe current default of length (bug #36976) http://cvs.php.net/viewcvs.cgi/phpdoc/en/reference/filesystem/functions/fgets.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc/en/reference/filesystem/functions/fgets.xml diff -u phpdoc/en/reference/filesystem/functions/fgets.xml:1.15 phpdoc/en/reference/filesystem/functions/fgets.xml:1.16 --- phpdoc/en/reference/filesystem/functions/fgets.xml:1.15 Fri Sep 16 11:30:14 2005 +++ phpdoc/en/reference/filesystem/functions/fgets.xml Wed Apr 5 16:20:04 2006 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> +<!-- $Revision: 1.16 $ --> <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 --> <refentry id="function.fgets"> <refnamediv> @@ -18,7 +18,8 @@ the file pointed to by <parameter>handle</parameter>. Reading ends when <parameter>length</parameter> - 1 bytes have been read, on a newline (which is included in the return value), or on EOF (whichever comes first). If no length - is specified, the length defaults to 1k, or 1024 bytes. + is specified, it will keep reading from the stream until it reaches + the end of the line. </para> <para> If an error occurs, returns &false;. @@ -56,9 +57,7 @@ <note> <simpara> 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. + 4.2.0. Until PHP 4.3.0, omitting it would assume 1024 as the line length. 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.