goba Sun Nov 11 06:53:49 2001 EDT
Modified files:
/phpdoc/en language-snippets.ent
Log:
Adding language snippet requested by Jim Winstead about false
and values evaluating to false
Index: phpdoc/en/language-snippets.ent
diff -u phpdoc/en/language-snippets.ent:1.8 phpdoc/en/language-snippets.ent:1.9
--- phpdoc/en/language-snippets.ent:1.8 Sun Aug 19 07:55:42 2001
+++ phpdoc/en/language-snippets.ent Sun Nov 11 06:53:49 2001
@@ -1,4 +1,4 @@
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
<!ENTITY warn.experimental '<warning><simpara>This module is
<emphasis>EXPERIMENTAL</emphasis>. That means, that the behaviour of these functions,
these function names, in concreto ANYTHING documented here can change in a future
release of PHP WITHOUT NOTICE. Be warned, and use this module at your own
risk.</simpara></warning>'>
<!ENTITY warn.experimental.func '<warning><simpara>This function is
<emphasis>EXPERIMENTAL</emphasis>. That means, that the behaviour of this function,
this function name, in concreto ANYTHING documented here can change in a future
release of PHP WITHOUT NOTICE. Be warned, and use this function at your own
risk.</simpara></warning>'>
@@ -6,6 +6,8 @@
<!ENTITY tip.ob-capture '<tip><simpara>As with anything that outputs its result
directly to the browser, you can use the <link linkend="ref.outcontrol">output-control
functions</link> to capture the output of this function, and save it - for example -
in a <type>string</type>.</simpara></tip>'>
<!ENTITY return.success 'Returns &true; on succes, &false; on failure.'>
+
+<!ENTITY return.falseproblem '<warning><simpara>This function may return &false;, but
+may also return a value evaluating to &false; in a simple if statement. Please use
+<link linkend="language.operators.comparison">the === operator</link> for testing the
+return value of this function.<simpara></warning>'>
<!-- Various notes -->
<!ENTITY note.not-bin-safe '<warning><simpara>This function is not (yet) binary
safe!</simpara></warning>'>
