cvs: /phpdoc/functions filesystem.sgml strings.sgml zlib.sgml

sr Thu Sep 23 04:49:02 1999 EDT Modified files: /phpdoc/functions filesystem.sgml strings.sgml zlib.sgml Log: Changed fgets() example to use feof(). Added documentation of allowable_tags parameters. Index: phpdoc/functions/filesystem.sgml diff -u phpdoc/functions/filesystem.sgml:1.7 phpdoc/functions/filesystem.sgml:1.8 --- phpdoc/functions/filesystem.sgml:1.7 Tue Sep 7 05:23:47 1999 +++ phpdoc/functions/filesystem.sgml Thu Sep 23 04:49:02 1999 @@ -450,7 +450,8 @@ <title>Reading a file line by line</title> <programlisting role=php> $fd = fopen("/tmp/inputfile.txt", "r"); -while ($buffer = fgets($fd, 4096)) { +while (!feof($fd)) { + $buffer = fgets($fd, 4096); echo $buffer; } fclose($fd); @@ -475,11 +476,20 @@ <funcdef>string <function>fgetss</function></funcdef> <paramdef>int <parameter>fp</parameter></paramdef> <paramdef>int <parameter>length</parameter></paramdef> + <paramdef>string <parameter><optional>allowable_tags</optional></parameter></paramdef> </funcsynopsis> <para> Identical to <function>fgets</function>, except that fgetss attempts to strip any HTML and PHP tags from the text it reads. + <para> + You can use the optional third parameter to specify tags which + should not be stripped. + + <note> + <para> + <parameter>allowable_tags</parameter> was added in PHP 3.0.13, PHP4B3. + </note> <para> See also <function>fgets</function>, <function>fopen</function>, Index: phpdoc/functions/strings.sgml diff -u phpdoc/functions/strings.sgml:1.15 phpdoc/functions/strings.sgml:1.16 --- phpdoc/functions/strings.sgml:1.15 Mon Sep 13 14:07:16 1999 +++ phpdoc/functions/strings.sgml Thu Sep 23 04:49:02 1999 @@ -1285,12 +1285,21 @@ <funcsynopsis> <funcdef>string <function>strip_tags</function></funcdef> <paramdef>string <parameter>str</parameter></paramdef> + <paramdef>string <parameter><optional>allowable_tags</optional></parameter></paramdef> </funcsynopsis> - <simpara> + <para> This function tries to strip all HTML and PHP tags from the given string. It errors on the side of caution in case of incomplete or bogus tags. It uses the same tag stripping state machine as the <function>fgetss</function> function. + <para> + You can use the optional second parameter to specify tags which + should not be stripped. + + <note> + <para> + <parameter>allowable_tags</parameter> was added in PHP 3.0.13, PHP4B3. + </note> </refsect1> </refentry> Index: phpdoc/functions/zlib.sgml diff -u phpdoc/functions/zlib.sgml:1.6 phpdoc/functions/zlib.sgml:1.7 --- phpdoc/functions/zlib.sgml:1.6 Tue Sep 7 05:23:47 1999 +++ phpdoc/functions/zlib.sgml Thu Sep 23 04:49:02 1999 @@ -179,8 +179,8 @@ <para> The file pointer must be valid, and must point to a file successfully opened by <function>gzopen</function>. - <para> See also - <function>gzopen</function>, and <function>gzgetc</function>. + <para> See also <function>gzopen</function>, + <function>gzgetc</function>, and <function>fgets</function>. </refsect1> </refentry> @@ -197,14 +197,24 @@ <funcdef>string <function>gzgetss</function></funcdef> <paramdef>int <parameter>zp</parameter></paramdef> <paramdef>int <parameter>length</parameter></paramdef> + <paramdef>string <parameter><optional>allowable_tags</optional></parameter></paramdef> </funcsynopsis> <para> Identical to <function>gzgets</function>, except that gzgetss attempts to strip any HTML and PHP tags from the text it reads. + <para> + You can use the optional third parameter to specify tags which + should not be stripped. + + <note> + <para> + <parameter>allowable_tags</parameter> was added in PHP 3.0.13, PHP4B3. + </note> <para> - See also <function>gzgets</function>, and <function>gzopen</function>. + See also <function>gzgets</function>, + <function>gzopen</function>, and <function>strip_tags</function>. </refsect1> </refentry>