cvs: phpdoc-zh /language functions.xml

From: Date: Mon, 15 Dec 2008 14:28:27 +0000
Subject: cvs: phpdoc-zh /language functions.xml
Groups: php.doc.zh 
Request: Send a blank email to doc-zh+get-3103@lists.php.net to get a copy of this message
eniac2008 Mon Dec 15 14:28:27 2008 UTC Modified files: /phpdoc-zh/language functions.xml Log: Sync with EN-Revision 1.69 File encoding changed from gb2312 to utf-8

http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/functions.xml?r1=1.25&r2=1.26&diff_format=u Index: phpdoc-zh/language/functions.xml diff -u phpdoc-zh/language/functions.xml:1.25 phpdoc-zh/language/functions.xml:1.26 --- phpdoc-zh/language/functions.xml:1.25 Sat Jun 23 13:32:42 2007 +++ phpdoc-zh/language/functions.xml Mon Dec 15 14:28:26 2008 @@ -1,20 +1,20 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.25 $ --> -<!-- $Author: bjori $ --> -<!-- EN-Revision: 1.60 Maintainer: verdana Status: ready --> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.26 $ --> +<!-- $Author: eniac2008 $ --> +<!-- EN-Revision: 1.69 Maintainer: eniac2008 Status: ready --> <!-- CREDITS: Gregory, dallas --> <chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook"> - <title>º¯Êý</title> + <title>函数</title> <sect1 xml:id="functions.user-defined"> - <title>Óû§×Ô¶¨Ò庯Êý</title> + <title>用户自定义函数</title> <para> - Ò»¸öº¯Êý¿ÉÓÉÒÔϵÄÓï·¨À´¶¨Ò壺 + 一个函数可由以下的语法来定义: </para> <para> <example> - <title>չʾº¯ÊýÓÃ;µÄα´úÂë</title> + <title>展示函数用途的伪代码</title> <programlisting role="php"> <![CDATA[ <?php @@ -30,31 +30,27 @@ </para> <simpara> - ÈκÎÓÐЧµÄ PHP ´úÂë¶¼ÓпÉÄܳöÏÖÔÚº¯ÊýÄÚ²¿£¬ÉõÖÁ°üÀ¨ÆäËüº¯ÊýºÍ<link - linkend="keyword.class">Àà</link>¶¨Òå¡£ + 任何有效的 PHP 代码都有可能出现在函数内部,甚至包括其它函数和<link + linkend="keyword.class">ç±»</link>定义。 </simpara> <para> - º¯ÊýÃûºÍ PHP ÖÐµÄÆäËü±êÇ©ÃüÃû¹æÔòÏàͬ¡£ÓÐЧµÄº¯ÊýÃûÒÔ×Öĸ»òÏ»®Ïß´òÍ·£¬ºóÃæ¸ú×Öĸ£¬Êý×Ö»òÏ»®Ïß¡£¿ÉÒÔÓÃÕýÔò±í´ïʽ±íʾΪ£º<literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal>¡£ + 函数名和 PHP 中的其它标识符命名规则相同。有效的函数名以字母或下划线打头,后面跟字母,数字或下划线。可以用正则表达式表示为:<literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal>。 </para> - <simpara> - ÔÚ PHP 3 ÖУ¬º¯Êý±ØÐëÔÚ±»µ÷ÓÃ֮ǰ¶¨Òå¡£¶ø PHP 4 - Ôò²»ÔÙÓÐÕâÑùµÄÌõ¼þ¡£<emphasis>³ý·Ç</emphasis>º¯ÊýÈçÒÔÏÂÁ½¸ö·¶ÀýÖÐÓÐÌõ¼þµÄ¶¨Òå¡£ - </simpara> + &tip.userlandnaming; <para> - Èç¹ûÒ»¸öº¯ÊýÒÔÒÔÏÂÁ½¸ö·¶ÀýµÄ·½Ê½ÓÐÌõ¼þµÄ¶¨Ò壬Æä¶¨Ò屨ÐëÔÚµ÷ÓÃ<emphasis>֮ǰ</emphasis>Íê³É¡£ + <emphasis>除非</emphasis>是下面两个例子中的情况,函数必须在其调用之前定义。 </para> <para> <example> - <title>ÓÐÌõ¼þµÄº¯Êý</title> + <title>条件函数(Conditional functions)</title> <programlisting role="php"> <![CDATA[ <?php $makefoo = true; -/* We can't call foo() from here - since it doesn't exist yet, - but we can call bar() */ +/* 我们不能在处调用foo()函数, + 因为它还不存在,但可以调用bar()函数。*/ bar(); @@ -65,8 +61,8 @@ } } -/* Now we can safely call foo() - since $makefoo evaluated to true */ +/* 现在我们可以安全调用函数 foo()了, + 因为 $makefoo 值为真 */ if ($makefoo) foo(); @@ -82,7 +78,7 @@ </para> <para> <example> - <title>º¯ÊýÖеĺ¯Êý</title> + <title>函数中的函数</title> <programlisting role="php"> <![CDATA[ <?php @@ -94,14 +90,12 @@ } } -/* We can't call bar() yet - since it doesn't exist. */ +/* 现在还不能调用bar()函数,因为它还不存在 */ foo(); -/* Now we can call bar(), - foo()'s processesing has - made it accessable. */ +/* 现在可以调用bar()函数了,因为foo()函数 + 的执行使得bar()函数变为已定义的函数 */ bar(); @@ -111,31 +105,27 @@ </example> </para> <para> - PHP ÖеÄËùÓк¯ÊýºÍÀà¶¼¾ßÓÐÈ«¾ÖÓò£¬¿ÉÒÔÔÚÄÚ²¿¶¨ÒåÍⲿµ÷Ó㬷´Ö®ÒàÈ»¡£ + PHP 中的所有函数和类都具有全局作用域,可以在内部定义外部调用,反之亦然。 </para> <simpara> - PHP ²»Ö§³Öº¯ÊýÖØÔØ£¬Ò²²»¿ÉÄÜÈ¡Ïû¶¨Òå»òÕßÖØ¶¨ÒåÒÑÉùÃ÷µÄº¯Êý¡£ + PHP 不支持函数重载,也不可能取消定义或者重定义已声明的函数。 </simpara> <note> <simpara> - º¯ÊýÃûÊÇ·Ç´óСдÃô¸ÐµÄ£¬²»¹ýÔÚµ÷Óú¯ÊýµÄʱºò£¬Í¨³£Ê¹ÓÃÆäÔÚ¶¨ÒåʱÏàͬµÄÐÎʽ¡£ + 函数名是大小写无关的,不过在调用函数的时候,通常使用其在定义时相同的形式。 </simpara> </note> <simpara> - PHP 3 ËäȻ֧³ÖĬÈϲÎÊý£¨¸ü¶àÐÅÏ¢Çë²ÎÕÕ<link - linkend="functions.arguments.default">ĬÈϲÎÊýµÄÖµ</link>£©£¬µ«ÊÇÈ´²»Ö§³Ö¿É±äµÄ²ÎÊý¸öÊý¡£PHP 4 - Ö§³Ö£º¼û<link - linkend="functions.variable-arg-list">¿É±ä³¤¶ÈµÄ²ÎÊýÁбí</link>ºÍÉæ¼°µ½µÄÏà¹Øº¯Êý - <function>func_num_args</function>£¬ - <function>func_get_arg</function>£¬ÒÔ¼° - <function>func_get_args</function> ÒÔ»ñÈ¡¸ü¶àµÄÐÅÏ¢¡£ + PHP 支持<link linkend="functions.variable-arg-list">可变数量的参数</link>和<link + linkend="functions.arguments.default">默认参数</link>。具体请参考: + <function>func_num_args</function>,<function>func_get_arg</function>,以及<function>func_get_args</function>。 </simpara> <para> - ÔÚ PHP ÖпÉÒÔµ÷Óõݹ麯Êý¡£µ«ÊÇÒª±ÜÃâµÝ¹éº¯Êý£¯·½·¨µ÷Óó¬¹ý - 100-200 ²ã£¬ÒòΪ¿ÉÄÜ»áÆÆ»µ¶ÑÕ»´Ó¶øÊ¹µ±Ç°½Å±¾ÖÕÖ¹¡£ + 在 PHP 中可以调用递归函数。但是要避免递归函数/方法调用超过 + 100-200 层,因为可能会破坏堆栈从而使当前脚本终止。 <example> - <title>µÝ¹éº¯Êý</title> + <title>递归函数</title> <programlisting role="php"> <![CDATA[ <?php @@ -154,23 +144,22 @@ </sect1> <sect1 xml:id="functions.arguments"> - <title>º¯ÊýµÄ²ÎÊý</title> + <title>函数的参数</title> <simpara> - ͨ¹ý²ÎÊýÁбí¿ÉÒÔ´«µÝÐÅÏ¢µ½º¯Êý£¬¼´ÒÔ¶ººÅ×÷Ϊ·Ö¸ô·ûµÄ±í´ïʽÁÐ±í¡£ + 通过参数列表可以传递信息到函数,即以逗号作为分隔符的表达式列表。 </simpara> <para> - PHP Ö§³Ö°´Öµ´«µÝ²ÎÊý£¨Ä¬ÈÏ£©£¬<link - linkend="functions.arguments.by-reference">ͨ¹ýÒýÓô«µÝ</link>ÒÔ¼°<link - linkend="functions.arguments.default">ĬÈϲÎÊý</link>¡£¿É±ä³¤¶È²ÎÊýÁбí½öÔÚ - PHP 4 ºÍºóÐø°æ±¾ÖÐÖ§³Ö£»¸ü¶àÐÅÏ¢Çë²ÎÕÕ<link - linkend="functions.variable-arg-list">¿É±ä³¤¶È²ÎÊýÁбí</link>ºÍÉæ¼°µ½µÄÏà¹Øº¯Êý - <function>func_num_args</function>£¬<function>func_get_arg</function> ÒÔ¼° - <function>func_get_args</function>¡£PHP 3 ÖÐͨ¹ý´«µÝÒ»¸öÊý×é²ÎÊý¿ÉÒÔ´ïµ½ÀàËÆµÄЧ¹û£º + PHP 支持按值传递参数(默认),<link + linkend="functions.arguments.by-reference">通过引用传递参数</link>以及<link + linkend="functions.arguments.default">默认参数</link>。也支持可变数量的参数;更多信息请参照<link + linkend="functions.variable-arg-list">可变长度参数列表</link>和涉及到的相关函数 + <function>func_num_args</function>,<function>func_get_arg</function> 以及 + <function>func_get_args</function>。 </para> <para> <example> - <title>Ïòº¯Êý´«µÝÊý×é</title> + <title>向函数传递数组</title> <programlisting role="php"> <![CDATA[ <?php @@ -185,17 +174,17 @@ </para> <sect2 xml:id="functions.arguments.by-reference"> - <title>ͨ¹ýÒýÓô«µÝ²ÎÊý</title> + <title>通过引用传递参数</title> <simpara> - ȱʡÇé¿öÏ£¬º¯Êý²ÎÊýͨ¹ýÖµ´«µÝ£¨Òò¶ø¼´Ê¹ÔÚº¯ÊýÄÚ²¿¸Ä±ä²ÎÊýµÄÖµ£¬Ëü²¢²»»á¸Ä±äº¯ÊýÍⲿµÄÖµ£©¡£Èç¹ûÏ£ÍûÔÊÐíº¯ÊýÐÞ¸ÄËüµÄ²ÎÊýÖµ£¬±ØÐëͨ¹ýÒýÓô«µÝ²ÎÊý¡£ + 缺省情况下,函数参数通过值传递(因而即使在函数内部改变参数的值,它并不会改变函数外部的值)。如果希望允许函数修改它的参数值,必须通过引用传递参数。 </simpara> <para> - Èç¹ûÏëÒªº¯ÊýµÄÒ»¸ö²ÎÊý×ÜÊÇͨ¹ýÒýÓô«µÝ£¬¿ÉÒÔÔÚº¯Êý¶¨ÒåÖиòÎÊýµÄÇ°ÃæÔ¤ÏȼÓÉÏ·ûºÅ &amp;£º + 如果想要函数的一个参数总是通过引用传递,可以在函数定义中该参数的前面预先加上符号 &amp;: </para> <para> <example> - <title>ÓÃÒýÓô«µÝº¯Êý²ÎÊý</title> + <title>用引用传递函数参数</title> <programlisting role="php"> <![CDATA[ <?php @@ -215,14 +204,14 @@ </sect2> <sect2 xml:id="functions.arguments.default"> - <title>ĬÈϲÎÊýµÄÖµ</title> + <title>默认参数的值</title> <para> - º¯Êý¿ÉÒÔ¶¨Òå C++ ·ç¸ñµÄ±êÁ¿²ÎÊýĬÈÏÖµ£¬ÈçÏ£º + 函数可以定义 C++ 风格的标量参数默认值,如下: </para> <para> <example> - <title>º¯ÊýÖÐĬÈϲÎÊýµÄÓÃ;</title> + <title>在函数中使用默认参数</title> <programlisting role="php"> <![CDATA[ <?php @@ -231,6 +220,7 @@ return "Making a cup of $type.\n"; } echo makecoffee(); +echo makecoffee(null); echo makecoffee("espresso"); ?> ]]> @@ -239,21 +229,22 @@ </para> <para> - ÉÏÃæ´úÂë¶ÎµÄÊä³öÊÇ£º + 上面代码段的输出是: </para> <para> <screen> Making a cup of cappuccino. +Making a cup of . Making a cup of espresso. </screen> </para> <para> - PHP »¹ÔÊÐíʹÓÃÊý×éºÍÌØÊâÀàÐÍ NULL ×÷ΪĬÈϲÎÊý£¬ÀýÈ磺 + PHP 还允许使用数组和特殊类型 NULL 作为默认参数,例如: </para> <para> <example> - <title>ʹÓ÷DZêÁ¿ÀàÐÍ×÷ΪĬÈϲÎÊý</title> + <title>使用非标量类型作为默认参数</title> <programlisting role="php"> <![CDATA[ <?php @@ -271,14 +262,14 @@ </para> <simpara> - ĬÈÏÖµ±ØÐëÊdz£Á¿±í´ïʽ£¬²»ÊÇ£¨ÀýÈ磩±äÁ¿£¬Àà³ÉÔ±£¬»òÕߺ¯Êýµ÷Óᣠ+ 默认值必须是常量表达式,不能是诸如变量,类成员,或者函数调用等表达式。 </simpara> <para> - Çë×¢Ò⵱ʹÓÃĬÈϲÎÊýʱ£¬ÈκÎĬÈϲÎÊý±ØÐë·ÅÔÚÈκηÇĬÈϲÎÊýµÄÓҲࣻ·ñÔò£¬¿ÉÄܺ¯Êý½«²»»á°´ÕÕÔ¤ÆÚµÄÇé¿ö¹¤×÷¡£¿¼ÂÇÏÂÃæµÄ´úÂëÆ¬¶Ï£º + 请注意当使用默认参数时,任何默认参数必须放在任何非默认参数的右侧;否则,函数将不会按照预期的情况工作。考虑下面的代码片断: </para> <para> <example> - <title>º¯ÊýĬÈϲÎÊý²»ÕýÈ·µÄÓ÷¨</title> + <title>函数默认参数不正确的用法</title> <programlisting role="php"> <![CDATA[ <?php @@ -294,7 +285,7 @@ </example> </para> <para> - ÉÏÊöÀý×ÓµÄÊä³öÊÇ£º + 上述例子的输出是: </para> <para> <screen> @@ -304,11 +295,11 @@ </screen> </para> <para> - ÏÖÔÚ£¬±È½ÏÉÏÃæµÄÀý×ÓºÍÕâ¸öÀý×Ó£º + 现在,比较上面的例子和这个例子: </para> <para> <example> - <title>º¯ÊýĬÈϲÎÊýÕýÈ·µÄÓ÷¨</title> + <title>函数默认参数正确的用法</title> <programlisting role="php"> <![CDATA[ <?php @@ -324,7 +315,7 @@ </example> </para> <para> - Õâ¸öÀý×ÓµÄÊä³öÊÇ£º + 这个例子的输出是: </para> <para> <screen> @@ -334,23 +325,23 @@ <note> <simpara> - ×Ô PHP 5 Æð£¬Ä¬ÈÏÖµ¿ÉÒÔͨ¹ýÒýÓô«µÝ¡£ + 自 PHP 5 起,默认值可以通过引用传递。 </simpara> </note> </sect2> <sect2 xml:id="functions.variable-arg-list"> - <title>¿É±ä³¤¶È²ÎÊýÁбí</title> + <title>可变数量的参数列表</title> <simpara> - PHP 4 ¼°¸ü¸ß°æ±¾ÒѾ­ÔÚÓû§×Ô¶¨Ò庯ÊýÖÐÖ§³Ö¿É±ä³¤¶È²ÎÊýÁÐ±í¡£Õâ¸öÕæµÄºÜ¼òµ¥£¬Óà - <function>func_num_args</function>£¬<function>func_get_arg</function>£¬ºÍ - <function>func_get_args</function> º¯Êý¡£ + PHP 4 及更高版本已经在用户自定义函数中支持可变数量的参数列表。其实很简单,只需使用 + <function>func_num_args</function>,<function>func_get_arg</function>,和 + <function>func_get_args</function> 函数即可。 </simpara> <simpara> - ÎÞÐèÌØ±ðµÄÓï·¨£¬²ÎÊýÁбíÈÔÈ»Äܹ»±»Ã÷È·ÎÞÎóµÄ´«µÝ¸øº¯Êý²¢ÇÒÕý³£ÔËת¡£ + 可变参数并不需要特别的语法,参数列表仍按函数定义的方式传递给函数,并按通常的方式使用这些参数。 </simpara> </sect2> @@ -358,15 +349,15 @@ </sect1> <sect1 xml:id="functions.returning-values"> - <title>·µ»ØÖµ</title> + <title>返回值</title> <para> - ֵͨ¹ýʹÓÿÉÑ¡µÄ·µ»ØÓï¾ä·µ»Ø¡£ÈκÎÀàÐͶ¼¿ÉÒÔ·µ»Ø£¬ÆäÖаüÀ¨ÁбíºÍ¶ÔÏó¡£Õâµ¼Öº¯ÊýÁ¢¼´½áÊøËüµÄÔËÐУ¬²¢ÇÒ½«¿ØÖÆÈ¨´«µÝ»ØËü±»µ÷ÓõÄÐС£¸ü¶àÐÅÏ¢¼û - <function>return</function>¡£ + 值通过使用可选的返回语句返回。可以返回包括数组和对象的任意类型。返回语句会立即中止函数的运行,并且将控制权交回调用该函数的代码行。更多信息见 + <function>return</function>。 </para> <para> <example> - <title><function>return</function> µÄÓ÷¨</title> + <title><function>return</function> 的使用</title> <programlisting role="php"> <![CDATA[ <?php @@ -382,11 +373,11 @@ </para> <para> - º¯Êý²»ÄÜ·µ»Ø¶à¸öÖµ£¬µ«ÎªÁË»ñµÃ¼òµ¥µÄ½á¹û£¬¿ÉÒÔ·µ»ØÒ»¸öÁÐ±í¡£ + 函数不能返回多个值,但可以通过返回一个数组来得到类似的效果。 </para> <para> <example> - <title>·µ»ØÒ»¸öÊý×éÒԵõ½¶à¸ö·µ»ØÖµ</title> + <title>返回一个数组以得到多个返回值</title> <programlisting role="php"> <![CDATA[ <?php @@ -401,11 +392,11 @@ </example> </para> <para> - ´Óº¯Êý·µ»ØÒ»¸öÒýÓ㬱ØÐëÔÚº¯ÊýÉùÃ÷ºÍÖ¸ÅÉ·µ»ØÖµ¸øÒ»¸ö±äÁ¿Ê±¶¼Ê¹ÓÃÒýÓòÙ×÷·û &amp; £º + 从函数返回一个引用,必须在函数声明和指派返回值给一个变量时都使用引用操作符 &amp; : </para> <para> <example> - <title>Óɺ¯Êý·µ»ØÒ»¸öÒýÓÃ</title> + <title>从函数返回一个引用</title> <programlisting role="php"> <![CDATA[ <?php @@ -421,26 +412,26 @@ </example> </para> <simpara> - ÓйØÒýÓõĸü¶àÐÅÏ¢, Çë²é¿´<link - linkend="language.references">ÒýÓõĽâÊÍ</link>¡£ + 有关引用的更多信息, 请查看<link + linkend="language.references">引用的解释</link>。 </simpara> </sect1> <sect1 xml:id="functions.variable-functions"> - <title>±äÁ¿º¯Êý</title> + <title>可变函数</title> <para> - PHP Ö§³Ö±äÁ¿º¯ÊýµÄ¸ÅÄî¡£ÕâÒâζ×ÅÈç¹ûÒ»¸ö±äÁ¿ÃûºóÓÐÔ²À¨ºÅ£¬PHP - ½«Ñ°ÕÒÓë±äÁ¿µÄֵͬÃûµÄº¯Êý£¬²¢ÇÒ½«³¢ÊÔÖ´ÐÐËü¡£³ýÁ˱ðµÄÊÂÇéÒÔÍ⣬Õâ¸ö¿ÉÒÔ±»ÓÃÓÚʵÏֻص÷º¯Êý£¬º¯Êý±íµÈµÈ¡£ + PHP 支持可变函数的概念。这意味着如果一个变量名后有圆括号,PHP + 将寻找与变量的值同名的函数,并且尝试执行它。可变函数可以用来实现包括回调函数,函数表在内的一些用途。 </para> <para> - ±äÁ¿º¯Êý²»ÄÜÓÃÓÚÓïÑԽṹ£¬ÀýÈç - <function>echo</function>£¬<function>print</function>£¬<function>unset</function>£¬<function>isset</function>£¬<function>empty</function>£¬<function>include</function>£¬<function>require</function> - ÒÔ¼°ÀàËÆµÄÓï¾ä¡£ÐèҪʹÓÃ×Ô¼ºµÄÍâ¿Çº¯ÊýÀ´½«ÕâЩ½á¹¹ÓÃ×÷±äÁ¿º¯Êý¡£ + 变量函数不能用于语言结构,例如 + <function>echo</function>,<function>print</function>,<function>unset</function>,<function>isset</function>,<function>empty</function>,<function>include</function>,<function>require</function> + 以及类似的语句。需要使用自己的包装函数来将这些结构用作变量函数。 </para> <para> <example> - <title>±äÁ¿º¯ÊýʾÀý</title> + <title>可变函数示例</title> <programlisting role="php"> <![CDATA[ <?php @@ -452,7 +443,7 @@ echo "In bar(); argument was '$arg'.<br />\n"; } -// This is a wrapper function around echo +// 使用 echo 的包装函数 function echoit($string) { echo $string; @@ -472,9 +463,9 @@ </example> </para> <para> - »¹¿ÉÒÔÀûÓñäÁ¿º¯ÊýµÄÌØÐÔÀ´µ÷ÓÃÒ»¸ö¶ÔÏóµÄ·½·¨¡£ + 还可以利用可变函数的特性来调用一个对象的方法。 <example> - <title>±äÁ¿·½·¨·¶Àý</title> + <title>可变方法范例</title> <programlisting role="php"> <![CDATA[ <?php @@ -502,43 +493,48 @@ </example> </para> <para> - Çë²ÎÔÄ <function>call_user_func</function>£¬<link - linkend="language.variables.variable">¿É±ä±äÁ¿</link>ºÍ - <function>function_exists</function>¡£ + 请参阅 <function>call_user_func</function>,<link + linkend="language.variables.variable">可变变量</link>和 + <function>function_exists</function>。 </para> </sect1> <sect1 xml:id="functions.internal"> - <title>ÄÚ²¿£¨ÄÚÖ㩺¯Êý</title> + <title>内部(内置)函数</title> <para> - PHP Óкܶà±ê×¼µÄº¯ÊýºÍ½á¹¹¡£»¹ÓÐһЩº¯ÊýÐèÒªºÍÌØ¶¨µØ PHP - À©Õ¹Ä£¿éÒ»Æð±àÒ룬·ñÔòÔÚʹÓÃËüÃǵÄʱºò¾Í»áµÃµ½Ò»¸öÖÂÃüµÄ¡°Î´¶¨Ò庯Êý¡±´íÎó¡£ÀýÈ磬ҪʹÓÃ<link - linkend="ref.image">ͼÏñ</link>º¯Êý±ÈÈç - <function>imagecreatetruecolor</function>£¬ÐèÒªÔÚ±àÒë PHP µÄʱºò¼ÓÉÏ - <productname>GD</productname> µÄÖ§³Ö¡£»òÕߣ¬ÒªÊ¹Óà - <function>mysql_connect</function> º¯Êý£¬¾ÍÐèÒªÔÚ±àÒë PHP µÄʱºò¼ÓÉÏ - <link linkend="ref.mysql">MySQL</link> Ö§³Ö¡£ÓкܶàºËÐĺ¯ÊýÒѰüº¬ÔÚÿ¸ö°æ±¾µÄ - PHP ÖÐÈç<link linkend="ref.strings">×Ö·û´®</link>ºÍ<link - linkend="ref.var">±äÁ¿</link>º¯Êý¡£µ÷Óà - <function>phpinfo</function> »òÕß <function>get_loaded_extensions</function> - ¿ÉÒÔµÃÖª PHP ¼ÓÔØÁËÄÇЩÀ©Õ¹¿â¡£Í¬Ê±»¹Ó¦¸Ã×¢Ò⣬ºÜ¶àÀ©Õ¹¿âĬÈϾÍÊÇÓÐЧµÄ¡£PHP - ÊֲᰴÕÕ²»Í¬µÄÀ©Õ¹¿â×éÖ¯ÁËËüÃǵÄÎĵµ¡£Çë²ÎÔÄ<link - linkend="configuration">ÅäÖÃ</link>£¬<link - linkend="install">°²×°</link>ÒÔ¼°¸÷×ÔµÄÀ©Õ¹¿âÕ½ÚÒÔ»ñÈ¡ÓйØÈçºÎÉèÖà PHP µÄÐÅÏ¢¡£ + PHP 有很多标准的函数和结构。还有一些函数需要和特定地 PHP + 扩展模块一起编译,否则在使用它们的时候就会得到一个致命的“未定义函数”错误。例如,要使用<link + linkend="ref.image">image</link>函数比如 + <function>imagecreatetruecolor</function>,需要在编译 PHP 的时候加上 + <productname>GD</productname> 的支持。或者,要使用 + <function>mysql_connect</function> 函数,就需要在编译 PHP 的时候加上 + <link linkend="ref.mysql">MySQL</link> 支持。有很多核心函数已包含在每个版本的 + PHP 中如<link linkend="ref.strings">字符串</link>和<link + linkend="ref.var">变量</link>函数。调用 + <function>phpinfo</function> 或者 <function>get_loaded_extensions</function> + 可以得知 PHP 加载了那些扩展库。同时还应该注意,很多扩展库默认就是有效的。PHP + 手册按照不同的扩展库组织了它们的文档。请参阅<link + linkend="configuration">配置</link>,<link + linkend="install">安装</link>以及各自的扩展库章节以获取有关如何设置 PHP 的信息。 </para> <para> - ÊÖ²áÖÐ<link - linkend="about.prototypes">ÈçºÎÔĶÁº¯ÊýÔ­ÐÍ</link>½²½âÁËÈçºÎÔĶÁºÍÀí½âÒ»¸öº¯ÊýµÄÔ­ÐÍ¡£È·ÈÏÒ»¸öº¯Êý½«·µ»ØÊ²Ã´£¬»òÕߺ¯ÊýÊÇ·ñÖ±½Ó×÷ÓÃÓÚ´«µÝµÄ²ÎÊýÊǺÜÖØÒªµÄ¡£ÀýÈ磬<function>str_replace</function> - º¯Êý½«·µ»ØÐ޸ĹýµÄ×Ö·û´®£¬¶ø <function>usort</function> - È´Ö±½Ó×÷ÓÃÓÚ´«µÝµÄ²ÎÊý±äÁ¿±¾Éí¡£ÊÖ²áÖУ¬Ã¿Ò»¸öº¯ÊýµÄÒ³ÃæÖж¼ÓйØÓÚº¯Êý²ÎÊý¡¢ÐÐΪ¸Ä±ä¡¢³É¹¦Óë·ñµÄ·µ»ØÖµÒÔ¼°Ê¹ÓÃÌõ¼þµÈÐÅÏ¢¡£Á˽âÕâÐ©ÖØÒªµÄ£¨³£³£ÊÇϸ΢µÄ£©²î±ðÊDZàдÕýÈ·µÄ - PHP ´úÂëµÄ¹Ø¼ü¡£ + 手册中<link + linkend="about.prototypes">如何阅读函数原型</link>讲解了如何阅读和理解一个函数的原型。确认一个函数将返回什么,或者函数是否直接作用于传递的参数是很重要的。例如,<function>str_replace</function> + 函数将返回修改过的字符串,而 <function>usort</function> + 却直接作用于传递的参数变量本身。手册中,每一个函数的页面中都有关于函数参数、行为改变、成功与否的返回值以及使用条件等信息。了解这些重要的(常常是细微的)差别是编写正确的 + PHP 代码的关键。 </para> + <note> + <simpara> + 如果传递给函数的参数类型与实际的类型不一致,例如将一个<type>array</type>传递给一个<type>string</type>类型的变量,那么函数的返回值是不确定的。在这种情况下,通常函数会返回&null;。但这仅仅是一个约定,并不一定如此。 + </simpara> + </note> <para> - ²Î¼û <function>function_exists</function>£¬<link - linkend="funcref">º¯Êý²Î¿¼</link>£¬<function>get_extension_funcs</function> - ºÍ <function>dl</function>¡£ + 参见 <function>function_exists</function>,<link + linkend="funcref">函数参考</link>,<function>get_extension_funcs</function> + 和 <function>dl</function>。 </para> </sect1>
« previous php.doc.zh (#3103) next »