cvs: phpdoc /en/language functions.xml

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>,