cvs: phpdoc-zh /language constants.xml

From: Date: Sun, 14 Dec 2008 13:55:29 +0000
Subject: cvs: phpdoc-zh /language constants.xml
Groups: php.doc.zh 
Request: Send a blank email to doc-zh+get-3096@lists.php.net to get a copy of this message
eniac2008 Sun Dec 14 13:55:29 2008 UTC Modified files: /phpdoc-zh/language constants.xml Log: File encoding changed from gb2312 to utf-8

http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/constants.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-zh/language/constants.xml diff -u phpdoc-zh/language/constants.xml:1.14 phpdoc-zh/language/constants.xml:1.15 --- phpdoc-zh/language/constants.xml:1.14 Sun Dec 14 13:34:13 2008 +++ phpdoc-zh/language/constants.xml Sun Dec 14 13:55:28 2008 @@ -1,32 +1,32 @@ -<?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.14 $ --> +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.15 $ --> <!-- $Author: eniac2008 $ --> <!-- EN-Revision: 1.55 Maintainer: eniac2008 Status: ready --> <!-- CREDITS: dallas,bjori --> <chapter xml:id="language.constants" xmlns="http://docbook.org/ns/docbook"> - <title>³£Á¿</title> + <title>常量</title> <simpara> - ³£Á¿ÊÇÒ»¸ö¼òµ¥ÖµµÄ±êʶ·û£¨Ãû×Ö£©¡£ÈçͬÆäÃû³ÆËù°µÊ¾µÄ£¬Ôڽű¾Ö´ÐÐÆÚ¼ä¸ÃÖµ²»Äܸı䣨³ýÁËËùνµÄ<link - linkend="language.constants.predefined">ħÊõ³£Á¿</link>£¬ËüÃÇÆäʵ²»Êdz£Á¿£©¡£³£Á¿Ä¬ÈÏΪ´óСдÃô¸Ð¡£Í¨³£³£Á¿±êʶ·û×ÜÊÇ´óдµÄ¡£ + 常量是一个简单值的标识符(名字)。如同其名称所暗示的,在脚本执行期间该值不能改变(除了所谓的<link + linkend="language.constants.predefined">魔术常量</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> &tip.userlandnaming; <para> <example> - <title>ºÏ·¨Óë·Ç·¨µÄ³£Á¿Ãû</title> + <title>合法与非法的常量名</title> <programlisting role="php"> <![CDATA[ <?php -// ºÏ·¨µÄ³£Á¿Ãû +// 合法的常量名 define("FOO", "something"); define("FOO2", "something else"); define("FOO_BAR", "something more"); -// ·Ç·¨µÄ³£Á¿Ãû +// 非法的常量名 define("2FOO", "something"); // This is valid, but should be avoided: @@ -42,72 +42,72 @@ <note> <simpara> - ÔÚÕâÀ×ÖĸÊÇ a-z£¬A-Z£¬ÒÔ¼°´Ó 127 µ½ 255£¨0x7f-0xff£©µÄ ASCII ×Ö·û¡£ + 在这里,字母是 a-z,A-Z,以及从 127 到 255(0x7f-0xff)的 ASCII 字符。 </simpara> </note> <simpara> - ºÍ &link.superglobals; Ò»Ñù£¬³£Á¿µÄ·¶Î§ÊÇÈ«¾ÖµÄ¡£²»ÓùÜ×÷ÓÃÓò¾Í¿ÉÒÔÔڽű¾µÄÈκεط½·ÃÎʳ£Á¿¡£ÓйØ×÷Óõøü¶àÐÅÏ¢ÇëÔĶÁÊÖ²áÖеÄ<link - linkend="language.variables.scope">±äÁ¿·¶Î§</link>¡£ + 和 &link.superglobals; 一样,常量的范围是全局的。不用管作用域就可以在脚本的任何地方访问常量。有关作用得更多信息请阅读手册中的<link + linkend="language.variables.scope">变量范围</link>。 </simpara> <sect1 xml:id="language.constants.syntax"> - <title>Óï·¨</title> + <title>语法</title> <simpara> - ¿ÉÒÔÓà <function>define</function> º¯ÊýÀ´¶¨Òå³£Á¿¡£ÔÚ - PHP 5.3.0 ÒԺ󣬿ÉÒÔʹÓà <literal>const</literal> - ¹Ø¼ü×ÖÔÚÀඨÒåµÄÍⲿ¶¨Òå³£Á¿¡£Ò»¸ö³£Á¿Ò»µ©±»¶¨Ò壬¾Í²»ÄÜÔٸıä»òÕßÈ¡Ïû¶¨Òå¡£ + 可以用 <function>define</function> 函数来定义常量。在 + PHP 5.3.0 以后,可以使用 <literal>const</literal> + 关键字在类定义的外部定义常量。一个常量一旦被定义,就不能再改变或者取消定义。 </simpara> <simpara> - ³£Á¿Ö»Äܰüº¬±êÁ¿Êý¾Ý£¨<type>boolean</type>£¬<type>integer</type>£¬<type>float</type> ºÍ <type>string</type>£©¡£ - ¿ÉÒÔ¶¨Òå <type>resource</type> ³£Á¿£¬µ«Ó¦¾¡Á¿±ÜÃ⣬ÒòΪ»áÔì³É²»¿ÉÔ¤ÁϵĽá¹û¡£ + 常量只能包含标量数据(<type>boolean</type>,<type>integer</type>,<type>float</type> 和 <type>string</type>)。 + 可以定义 <type>resource</type> 常量,但应尽量避免,因为会造成不可预料的结果。 </simpara> <simpara> - ¿ÉÒÔ¼òµ¥µÄͨ¹ýÖ¸¶¨ÆäÃû×ÖÀ´È¡µÃ³£Á¿µÄÖµ£¬Óë±äÁ¿²»Í¬£¬<emphasis>²»Ó¦¸Ã</emphasis>ÔÚ³£Á¿Ç°Ãæ¼ÓÉÏ - <literal>$</literal> ·ûºÅ¡£Èç¹û³£Á¿ÃûÊǶ¯Ì¬µÄ£¬Ò²¿ÉÒÔÓú¯Êý - <function>constant</function> À´»ñÈ¡³£Á¿µÄÖµ¡£Óà - <function>get_defined_constants</function> ¿ÉÒÔ»ñµÃËùÓÐÒѶ¨ÒåµÄ³£Á¿ÁÐ±í¡£ + 可以简单的通过指定其名字来取得常量的值,与变量不同,<emphasis>不应该</emphasis>在常量前面加上 + <literal>$</literal> 符号。如果常量名是动态的,也可以用函数 + <function>constant</function> 来获取常量的值。用 + <function>get_defined_constants</function> 可以获得所有已定义的常量列表。 </simpara> <note> <simpara> - ³£Á¿ºÍ£¨È«¾Ö£©±äÁ¿ÔÚ²»Í¬µÄÃû×Ö¿Õ¼äÖС£ÕâÒâζ×ÅÀýÈç &true; ºÍ <varname>$TRUE</varname> ÊDz»Í¬µÄ¡£ + 常量和(全局)变量在不同的名字空间中。这意味着例如 &true; 和 <varname>$TRUE</varname> 是不同的。 </simpara> </note> <simpara> - Èç¹ûʹÓÃÁËÒ»¸ö䶨ÒåµÄ³£Á¿£¬PHP - ¼Ù¶¨ÏëÒªµÄÊǸó£Á¿±¾ÉíµÄÃû×Ö£¬ÈçͬÓÃ×Ö·û´®µ÷ÓÃËüÒ»Ñù£¨CONSTANT ¶ÔÓ¦ - "CONSTANT"£©¡£´Ëʱ½«·¢³öÒ»¸ö <link linkend="ref.errorfunc">E_NOTICE</link> - ¼¶µÄ´íÎ󡣲μûÊÖ²áÖÐΪʲô + 如果使用了一个未定义的常量,PHP + 假定想要的是该常量本身的名字,如同用字符串调用它一样(CONSTANT 对应 + "CONSTANT")。此时将发出一个 <link linkend="ref.errorfunc">E_NOTICE</link> + 级的错误。参见手册中为什么 <link linkend="language.types.array.foo-bar">$foo[bar]</link> - ÊÇ´íÎóµÄ£¨³ý·ÇÊÂÏÈÓà <function>define</function> ½« <literal>bar</literal> - ¶¨ÒåΪһ¸ö³£Á¿£©¡£Èç¹ûÖ»Ïë¼ì²éÊÇ·ñ¶¨ÒåÁËij³£Á¿£¬Óà <function>defined</function> º¯Êý¡£ + 是错误的(除非事先用 <function>define</function> 将 <literal>bar</literal> + 定义为一个常量)。如果只想检查是否定义了某常量,用 <function>defined</function> 函数。 </simpara> <para> - ³£Á¿ºÍ±äÁ¿ÓÐÈçϲ»Í¬£º + 常量和变量有如下不同: <itemizedlist> <listitem> <simpara> - ³£Á¿Ç°ÃæÃ»ÓÐÃÀÔª·ûºÅ£¨<literal>$</literal>£©£» + 常量前面没有美元符号(<literal>$</literal>); </simpara> </listitem> <listitem> <simpara> - ³£Á¿Ö»ÄÜÓà <function>define</function> º¯Êý¶¨Ò壬¶ø²»ÄÜͨ¹ý¸³ÖµÓï¾ä£» + 常量只能用 <function>define</function> 函数定义,而不能通过赋值语句; </simpara> </listitem> <listitem> <simpara> - ³£Á¿¿ÉÒÔ²»ÓÃÀí»á±äÁ¿µÄ×÷ÓÃÓò¶øÔÚÈκεط½¶¨ÒåºÍ·ÃÎÊ£» + 常量可以不用理会变量的作用域而在任何地方定义和访问; </simpara> </listitem> <listitem> <simpara> - ³£Á¿Ò»µ©¶¨Òå¾Í²»Äܱ»ÖØÐ¶¨Òå»òÕßÈ¡Ïû¶¨Ò壻 + 常量一旦定义就不能被重新定义或者取消定义; </simpara> </listitem> <listitem> <simpara> - ³£Á¿µÄÖµÖ»ÄÜÊDZêÁ¿¡£ + 常量的值只能是标量。 </simpara> </listitem> </itemizedlist> @@ -115,7 +115,7 @@ <para> <example> - <title>¶¨Òå³£Á¿</title> + <title>定义常量</title> <programlisting role="php"> <![CDATA[ <?php @@ -130,11 +130,11 @@ <para> <example> - <title>ʹÓùؼü×Ö <literal>const</literal> ¶¨Òå³£Á¿</title> + <title>使用关键字 <literal>const</literal> 定义常量</title> <programlisting role="php"> <![CDATA[ <?php -// ÒÔÏ´úÂëÔÚ PHP 5.3.0 ºó¿ÉÒÔÕý³£¹¤×÷ +// 以下代码在 PHP 5.3.0 后可以正常工作 const CONSTANT = 'Hello World'; echo CONSTANT; @@ -145,79 +145,79 @@ </para> <simpara> - ²Î¼û<link linkend="language.oop5.constants">Àà³£Á¿</link>¡£ + 参见<link linkend="language.oop5.constants">类常量</link>。 </simpara> </sect1> <sect1 xml:id="language.constants.predefined"> - <title>ħÊõ³£Á¿</title> + <title>魔术常量</title> <simpara> - PHP ÏòËüÔËÐеÄÈκνű¾ÌṩÁË´óÁ¿µÄ<link - linkend="reserved.constants">Ô¤¶¨Òå³£Á¿</link>¡£²»¹ýºÜ¶à³£Á¿¶¼ÊÇÓɲ»Í¬µÄÀ©Õ¹¿â¶¨ÒåµÄ£¬Ö»ÓÐÔÚ¼ÓÔØÁËÕâЩÀ©Õ¹¿âʱ²Å»á³öÏÖ£¬»òÕß¶¯Ì¬¼ÓÔØºó£¬»òÕßÔÚ±àÒëʱÒѾ­°üÀ¨½øÈ¥ÁË¡£ + PHP 向它运行的任何脚本提供了大量的<link + linkend="reserved.constants">预定义常量</link>。不过很多常量都是由不同的扩展库定义的,只有在加载了这些扩展库时才会出现,或者动态加载后,或者在编译时已经包括进去了。 </simpara> <para> - ÓÐÆß¸öħÊõ³£Á¿ËüÃǵÄÖµËæ×ÅËüÃÇÔÚ´úÂëÖеÄλÖÃ¸Ä±ä¶ø¸Ä±ä¡£ÀýÈç - <constant>__LINE__</constant> µÄÖµ¾ÍÒÀÀµÓÚËüÔڽű¾ÖÐËù´¦µÄÐÐÀ´¾ö¶¨¡£ÕâÐ©ÌØÊâµÄ³£Á¿²»Çø·Ö´óСд£¬ÈçÏ£º + 有七个魔术常量它们的值随着它们在代码中的位置改变而改变。例如 + <constant>__LINE__</constant> 的值就依赖于它在脚本中所处的行来决定。这些特殊的常量不区分大小写,如下: </para> <para> <table> - <title>¼¸¸ö PHP µÄ¡°Ä§Êõ³£Á¿¡±</title> + <title>几个 PHP 的“魔术常量”</title> <tgroup cols="2"> <thead> <row> - <entry>Ãû³Æ</entry> - <entry>˵Ã÷</entry> + <entry>名称</entry> + <entry>说明</entry> </row> </thead> <tbody> <row> <entry><constant>__LINE__</constant></entry> <entry> - ÎļþÖеĵ±Ç°Ðкš£ + 文件中的当前行号。 </entry> </row> <row> <entry><constant>__FILE__</constant></entry> <entry> - ÎļþµÄÍêÕû·¾¶ºÍÎļþÃû¡£Èç¹ûÓÃÔÚ±»°üº¬ÎļþÖУ¬Ôò·µ»Ø±»°üº¬µÄÎļþÃû¡£×Ô - PHP 4.0.2 Æð£¬<constant>__FILE__</constant> - ×ÜÊǰüº¬Ò»¸ö¾ø¶Ô·¾¶£¨Èç¹ûÊÇ·ûºÅÁ¬½Ó£¬ÔòÊǽâÎöºóµÄ¾ø¶Ô·¾¶£©£¬¶øÔÚ´Ë֮ǰµÄ°æ±¾ÓÐʱ»á°üº¬Ò»¸öÏà¶Ô·¾¶¡£ + 文件的完整路径和文件名。如果用在被包含文件中,则返回被包含的文件名。自 + PHP 4.0.2 起,<constant>__FILE__</constant> + 总是包含一个绝对路径(如果是符号连接,则是解析后的绝对路径),而在此之前的版本有时会包含一个相对路径。 </entry> </row> <row> <entry><constant>__DIR__</constant></entry> <entry> - ÎļþËùÔÚµÄĿ¼¡£Èç¹ûÓÃÔÚ±»°üÀ¨ÎļþÖУ¬Ôò·µ»Ø±»°üÀ¨µÄÎļþËùÔÚµÄĿ¼¡£ËüµÈ¼ÛÓÚ - <literal>dirname(__FILE__)</literal>¡£³ý·ÇÊǸùĿ¼£¬·ñÔòĿ¼ÖÐÃû²»°üÀ¨Ä©Î²µÄб¸Ü¡££¨PHP 5.3.0ÖÐÐÂÔö£© + 文件所在的目录。如果用在被包括文件中,则返回被包括的文件所在的目录。它等价于 + <literal>dirname(__FILE__)</literal>。除非是根目录,否则目录中名不包括末尾的斜杠。(PHP 5.3.0中新增) = </entry> </row> <row> <entry><constant>__FUNCTION__</constant></entry> <entry> - º¯ÊýÃû³Æ£¨PHP 4.3.0 мӣ©¡£×Ô PHP 5 - Æð±¾³£Á¿·µ»Ø¸Ãº¯Êý±»¶¨ÒåʱµÄÃû×Ö£¨Çø·Ö´óСд£©¡£ÔÚ - PHP 4 ÖиÃÖµ×ÜÊÇСд×ÖĸµÄ¡£ + 函数名称(PHP 4.3.0 新加)。自 PHP 5 + 起本常量返回该函数被定义时的名字(区分大小写)。在 + PHP 4 中该值总是小写字母的。 </entry> </row> <row> <entry><constant>__CLASS__</constant></entry> <entry> - ÀàµÄÃû³Æ£¨PHP 4.3.0 мӣ©¡£×Ô PHP 5 - Æð±¾³£Á¿·µ»Ø¸ÃÀà±»¶¨ÒåʱµÄÃû×Ö£¨Çø·Ö´óСд£©¡£ÔÚ - PHP 4 ÖиÃÖµ×ÜÊÇСд×ÖĸµÄ¡£ + 类的名称(PHP 4.3.0 新加)。自 PHP 5 + 起本常量返回该类被定义时的名字(区分大小写)。在 + PHP 4 中该值总是小写字母的。 </entry> </row> <row> <entry><constant>__METHOD__</constant></entry> <entry> - ÀàµÄ·½·¨Ãû£¨PHP 5.0.0 мӣ©¡£·µ»Ø¸Ã·½·¨±»¶¨ÒåʱµÄÃû×Ö£¨Çø·Ö´óСд£©¡£ + 类的方法名(PHP 5.0.0 新加)。返回该方法被定义时的名字(区分大小写)。 </entry> </row> <row> <entry><constant>__NAMESPACE__</constant></entry> <entry> - µ±Ç°ÃüÃû¿Õ¼äµÄÃû³Æ£¨´óСдÃô¸Ð£©¡£Õâ¸ö³£Á¿ÊÇÔÚ±àÒëʱ¶¨ÒåµÄ£¨ÔÚPHP5.3.0ÖÐÐÂÔöµÄ£© + 当前命名空间的名称(大小写敏感)。这个常量是在编译时定义的(PHP 5.3.0 新增) </entry> </row> </tbody> @@ -225,8 +225,8 @@ </table> </para> <para> - ²Î¼û - <function>get_class</function>£¬<function>get_object_vars</function>£¬<function>file_exists</function>&listendand;<function>function_exists</function>¡£ + 参见 + <function>get_class</function>,<function>get_object_vars</function>,<function>file_exists</function>&listendand;<function>function_exists</function>。 </para> </sect1>
« previous php.doc.zh (#3096) next »