philip Thu Aug 31 17:55:45 2006 UTC
Modified files:
/phpdoc/en/language functions.xml
Log:
Document unexpected/undefined return types, closes bug #38130
# Thanks to (btherl at yahoo dot com dot au) for the initial write-up
http://cvs.php.net/viewvc.cgi/phpdoc/en/language/functions.xml?r1=1.62&r2=1.63&diff_format=u
Index: phpdoc/en/language/functions.xml
diff -u phpdoc/en/language/functions.xml:1.62
phpdoc/en/language/functions.xml:1.63
--- phpdoc/en/language/functions.xml:1.62 Fri Aug 11 16:55:35 2006
+++ phpdoc/en/language/functions.xml Thu Aug 31 17:55:45 2006
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.62 $ -->
+<!-- $Revision: 1.63 $ -->
<chapter id="language.functions">
<title>Functions</title>
@@ -596,6 +596,15 @@
Knowing these important (yet often subtle) differences is crucial for
writing correct PHP code.
</para>
+ <note>
+ <simpara>
+ If the parameters given to a function are not what it expects, such as
+ passing an <type>array</type> where a <type>string</type> is expected,
+ the return value of the function is undefined. In this case it will
+ likely return &null; but this is just a convention, and cannot be relied
+ upon.
+ </simpara>
+ </note>
<para>
See also <function>function_exists</function>,
<link linkend="funcref">the function reference</link>,
