cvs: phpdoc-ar /language constants.xml
| From: | Hafid Benhadria | Date: | Fri, 29 Aug 2003 18:53:18 +0000 |
| Subject: | cvs: phpdoc-ar /language constants.xml | ||
| Groups: | php.doc.ar | ||
| Request: | Send a blank email to doc-ar+get-566@lists.php.net to get a copy of this message | ||
hafid Fri Aug 29 14:53:18 2003 EDT
Modified files:
/phpdoc-ar/language constants.xml
Log:
Updated to EN 1.34 . Added standard EN-Revision tag.
Index: phpdoc-ar/language/constants.xml diff -u phpdoc-ar/language/constants.xml:1.1 phpdoc-ar/language/constants.xml:1.2 --- phpdoc-ar/language/constants.xml:1.1 Mon Mar 25 13:09:48 2002 +++ phpdoc-ar/language/constants.xml Fri Aug 29 14:53:17 2003 @@ -1,115 +1,218 @@ -<?xml version="1.0" encoding="iso-8859-6"?> -<!-- $EN-Revision: 1.24 $ --> - <chapter id="language.constants"> - <title>ÇäËèÇÈÊ</title> - - <simpara> ÇäËÇÈÊ çè ÑåÒ åÙÑñá äâêåÉ åǬ -èãåÇ çè èÇÖÍ åæ ÇäÊÓåêÉ áÅæ ÇäâêåÉ äÇ êåãæ Ãæ ÊÊÚêÑ ÎäÇä ÊæáêÐ ÇäÈÑæÇåÌ. - ('ÇäËèÇÈÊ ÇäååêÒÉ' <constant>__FILE__</constant> è <constant>__LINE__</constant> ÊÈÏè ÇÓÊËæÇÁ äçÐç ÇäâÇÙÏɬ -äãæçÇ äêÓÊ ËèÇÈÊ áÙäêÇë.) -ÇäËÇÈÊ êÊÃËÑ ÈÍÇäÉ ÇäÍÑèá ÇäÕÚêÑÉ èÇäãÈêÑÉ ÇáÊÑÇÖêÇë. èâÏ ÌÑÊ ÇäÙÇÏÉ Ãæ Êãèæ ÇäËèÇÈÊ ÏÇÆåÇë ÈÃÍÑá ãÈêÑÉ . -</simpara> - <para> ÇÓå ÇäËÇÈÊ êÊÈÙ æáÓ ÇäÔÑè× äÃê ÊÓåêÉ áê äÚÉ ÇäÈê ÅÊÔ Èê. -ÇäÇÓå ÇäÕÍêÍ ääËÇÈÊ êÈÏà ÈÍÑá Ãè ÔÑ×É Óáäêɬ åÊÈèÙÉ ÈÃê ÙÏÏ åæ ÇäÍÑèᬠÇäÃÑâÇå Ãè ÇäÔÑ× ÇäÓáäêÉ . èÈÊÙÈêÑ âêÇÓê êåãæ ÊåËêä âÇÙÏÉ ÇÓå ÇäËÇÈÊ çãÐÇ :<literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal> - - <!-- TODO: Example of valid & invalid constant names --> - </para> - - <note> - <simpara> çæÇ ÓæÙÊÈÑ ÇäÍÑá çè ÃÍÏ ÇäÍÑèá ÇäçÌÇÆêÉ ÇäÇæÌäêÒêÉ a-z è A-Z èÑåèÒ ASCII ÐÇÊ ÇäâêåÉ åæ 127 èÍÊé 255 (Ox7f-Oxff). -</simpara> - </note> - - <simpara> åÏé (æ×Çâ) ÇÓÊÎÏÇå ÇäËÇÈÊ åÏéë ÔÇåä¬ ÍêË ÊÓÊ×êÙ ÇäèÕèä Åäêç åæ Ãê åãÇæ ÏÇÎä ÈÑæÇåÌã Ïèæ ÇçÊåÇå ääåÏé.</simpara> - - <sect1 id="language.constants.syntax"> - <title>ÇäÕêÚÉ</title> - <simpara> ÊÓÊ×êÙ Ãæ ÊÙÑá ËÇÈÊÇë ÈÇÓÊÎÏÇå ÏÇäÉ <function>define</function>. ÍêæåÇ êÊå ÊÙÑêá ÇäËÇÈÊ äÇ êåãæ ÙæÏÆÐ Ãæ êÊÚêÑ Ãè êÒÇä ÊÙÑêáç. -</simpara> - <simpara> ÇäÈêÇæÇÊ ÇäâêÇÓêÉ áâ× (<type>boolean</type>, <type>integer</type>, - <type>double</type> è <type>string</type>) êåãæ ÇÓÊÎÏÇåçÇ áê ÇäËèÇÈÊ. - </simpara> - <simpara> ÊÓÊ×êÙ ÇäÍÕèä Ùäé âêåÉ Ãê ËÇÈÊ Ùæ ×Ñêâ ÊÍÏêÏ ÇÓåç ÈÈÓÇ×ç. - Ùäé ÙãÓ ÇäåÊÚêÑÇʬ êÌÈ Ãæ <emphasis>äÇ</emphasis> ÊÓÈâ ÇäËÇÈÊ ÈÙäÇåÉ<literal>$</literal> -. ÊÓÊ×êÙ ÇÓÊÎÏÇå ÇäÏÇäÉ <function>constant</function>¬ äâÑÇÁÉ âêåÉ ÇäËÇÈʬ ÇÐÇ ãæÊ ÊÑÚÈ áê ÇÓÊÎÏÇå ÇÓå ÇäËÇÈÊ ÏêæÇåêãêÇë. - ÊÓÊ×êÙ ÇêÖÇë ÇÓÊÎÏÇå <function>get_defined_constants</function> ääÍÕèä Ùäé âÇÆåÉ Èãä ÇäËèÇÈÊ ÇäåÙÑáÉ . - </simpara> - <note> - <simpara> ÇäËèÇÈÊ è ÇäåÊÚêÑÇÊ (ÇäÔÇåäÉ) ÊâÙ áê åèÇâÙ åÎÊäáɬ ååÇ êæÊÌ Ùæ Ðäã åËäÇë ãèæ &true; è - <varname>$TRUE</varname> åÎÊäáÇæ ÊåÇåÇë.</simpara> - </note> - <simpara> - ÙæÏåÇ ÊÓÊÎÏå ËÇÈÊÇë ÚêÑ åÙÑᬠáÓêáÊÑÖ PHP Ãæã ÊÙæê ÇÓÊÎÏÇå ÇÓå ÇäËÇÈÊ æáÓç èäêÓ ÇäâêåÉ. -Óèá êÕÏÑ <link linkend="features.error-handling">ÊæÈêç</link> ÙæÏåÇ ÊÍÏË åËä çÐç ÇäÍÇäÉ. äÐäã êåãæã ÇÓÊÎÏÇå ÇäÏÇäÉ <function>defined</function> ÇÐÇ ÃÑÏÊ Ãæ ÊÙÑá åÇ ÅÐÇ ãÇæ ÇäËÇÈÊ âÏ Êå ÊÙÑêáç.</simpara> - <para> çÐç çê ÇäÇÎÊäÇáÇÊ Èêæ ÇäËèÇÈÊ èÇäåÊÚêÑÇÊ : - <itemizedlist> - <listitem> - <simpara> ÇäËèÇÈÊ äÇ ÊÓÊÎÏå ÙäÇåÉ ÇäÏèäÇÑ (<literal>$</literal>) âÈäçÇ» </simpara> - </listitem> - <listitem> - <simpara> ÇäËèÇÈÊ êåãæ Ãæ êÊå ÊÙÑêáçÇ áâ× åæ ÎäÇä ÇäÏÇäÉ <function>define</function>, èäêÓ Ùæ ×Ñêâ ÊÙêêæ ÈÓê×; </simpara> - </listitem> - <listitem> - <simpara> ÇäËèÇÈÊ êåãæ ÊÙÑêáçÇ èÊÎÕêÕçÇ áê Ãê åãÇæ Ïèæ ÇäÇçÊåÇå ÈÔÑè× åÏé ÇäåÊÚêÑÇÊ» </simpara> - </listitem> - <listitem> - <simpara> ÇäËèÇÈÊ äÇ êåãæ ÅÙÇÏÉ ÊÙÑêáçÇ Ãè ÅÒÇäÉ ÊÙÑêáçǬ ÙæÏåÇ êÊå ÊÙÑêáçÇ åÑÉ ÊÕÈÍ åÙêæÉ ÈÔãä æçÇÆê» - </simpara> - </listitem> - <listitem> - <simpara> ÇäËèÇÈÊ êåãæ Ãæ ÊâÏÑ Èâêå âêÇÓêÉ áâ×.</simpara> - </listitem> - </itemizedlist> - </para> - - <para> - <example> - <title>ÊÙÑêá ÇäËèÇÈÊ</title> - <programlisting role="php"> -<![CDATA[ -<?php -define("CONSTANT", "Hello world."); -echo CONSTANT; // outputs "Hello world." -echo Constant; // outputs "Constant" and issues a notice. -?>]]> - </programlisting> - </example> - - </para> - </sect1> - - <sect1 id="language.constants.predefined"> - <title>ÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë</title> - - <simpara> ÊÒèÏ PHP ÙÏÏÇë ãÈêÑÇë åæ ÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë äÃê ÈÑæÇåÌ êæáÐ. - ÇäÙÏêÏ åæ çÐç ÇäËèÇÈÊ ÙåèåÇë ÊæÔà ÈèÇÓ×É ÇäÙÏêÏ åæ ÇäÇåÊÏÇÏÇÊ (extensions)¬ èÊãèæ ÍÇÖÑÉ ÙæÏåÇ Êãèæ çÐç ÇäÇåÊÏÇÏÇÊ åÊèáÑÉ áâ׬ ÅåÇ ÙÈÑ ÊÍåêäçÇ ÏêæÇåêãêÇë Ãè Ãæ Êãèæ åÏåÌÉ ÃËæÇÁ ÇäÊÑãêÈ. -</simpara> - - <simpara> âÇÆåÉ ÈÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë åèÌèÏÉ áê çÐÇ ÇäâÓå <link - linkend="reserved.constants">ÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë</link> -. </simpara> - - - </sect1> - </chapter> - -<!-- Keep this comment at the end of the file -Local variables: -mode: sgml -sgml-omittag:t -sgml-shorttag:t -sgml-minimize-attributes:nil -sgml-always-quote-attributes:t -sgml-indent-step:1 -sgml-indent-data:t -indent-tabs-mode:nil -sgml-parent-document:nil -sgml-default-dtd-file:"../../manual.ced" -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: -vim600: syn=xml fen fdm=syntax fdl=2 si -vim: et tw=78 syn=sgml -vi: ts=1 sw=1 ---> +<?xml version="1.0" encoding="ISO-8859-6"?> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.34 Maintainer: visualmind Status: ready --> +<chapter id="language.constants"> + <title>ÇäËèÇÈÊ</title> + <simpara> + ÇäËÇÈÊ çè åïÙîÑñðá (ÅÓå) äâêåÉ ÈÓê×É. èãåÇ ÊèÍê Åäêç ÇäÊñÓåêɬ + áÅæñ çÐç ÇäâêåÉ äÇ êåãæ Ãæ ÊÊÚêÑ ÎäÇä ÊæáêÐ + ÇäÎÇ×è× (ÈÇÓÊËæÇÁ åÇ êÎÕ <link linkend="language.constants.predefined"> + ÇäËèÇÈÊ ÇäÓñðÍÑêñÉ</link> ÇäÊê äÇ ÊïÙîÏï ÍÇäêÇ Ùäé ÃæñçÇ ËèÇÈÊ). + êÊÓå ÇäËÇÈË Èãèæç åïÊîÍîÓñðÓ äÍÇäÉ ÇäÃÍÑá èÐäã ÈÔãä ÇáÊÑÇÖê. èâÏ ÏÑÌÊ ÇäÙÇÏÉ Ãæ Êãèæ åïÙÑñðáÇÊ ÇäËÇÈÊ + ÏèåÇ ÈÃÍÑá ãÈêÑÉ. + </simpara> + <para> + êÊÈÙ ÅÓå ÇäËÇÈÊ æáÓ âèÇÙÏ ÃêÉ ÊÓåêÉ áê PHP. + ÅÓå ËÇÈÊ ÕÇäÍ êÈÏà ÈÍÑá Ãè ÔÑ×É Óáäêñɬ åÊÈèÙÇ + ÈÃê ÙÏÏ åæ ÇäÍÑèᬠÇäÃÑâÇå Ãè ÇäÔñÑ×ÇÊ ÇäÓñáäêñÉ. èãÙÈÇÑÉ ÇÙÊêÇÏêñɬ + ÓêÊå ÇäÊÙÈêÑ ÙæçÇ çãÐÇ: + <literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal> + <!-- TODO: Example of valid & invalid constant names --> + </para> + <note> + <simpara> + áê åÙÑÖ çÐǬ áÅæñ ÇäÍÑá êÊåËä áê a-z¬ A-Z áê Íêæ ÊåÊÏ ÍÑèá ASCII + åæ 127 Åäé ÚÇêÉ 255 (0x7f-0xff). + </simpara> + </note> + <simpara> + åËä &link.superglobals;¬ áÅæñ ÇäåÏé ÇäÎÇÕ ÈËÇÈÊí åÇ êÊÓå Èãèæç ÔÇåäÇë. + êåãæã èäèÌ ÇäËèÇÈÊ ÈÃê åãÇæ áê ÎÇ×è×ã ÈÚÖ ÇäæØÑ Ùæ ÇäåÏé. + äåÒêÏ åæ ÇäåÙäèåÇÊ ÈÎÕèÕ ÇäåÏé¬ ÇâÑà áÕä ÇäÏñäêä ÇäåÊÙäâ Èà + <link linkend="language.variables.scope">åÏé ÇäåÊÚêÑÇÊ</link>. + </simpara> + <sect1 id="language.constants.syntax"> + <title>ÇäÕñêÚÉ</title> + <simpara> + êåãæã ÊÙÑêá ËÇÈÊ ÈÇÓÊÎÏÇå ÏÇäÉ + <function>define</function>. ÈåÌÑÏ ÊÙÑêá ÊÙÑêá ÇäËÇÈʬ + êÕÈÍ åÓÊÙÕêÇ èääÃÈÏ ÊÚêêÑç Ãè ÅÒÇäÉ ÊÙÑêáç. + </simpara> + <simpara> + áâ× ÇäÈêÇæÇÊ ÇäÃÍÇÏêñÉ ÇäâêåÉ (<type>boolean</type>¬ <type>integer</type>¬ + <type>float</type> è <type>string</type>) êåãæ ÊÖåêæçÇ + áê ËèÇÈÊ. + </simpara> + <simpara> + êåãæã ÇäÍÕèä Ùäé âêåÉ ËÇÈʬ ÈÈÓÇ×ɬ Ùæ ×Ñêâ ÊÍÏêÏ ÇÓåç. + Ùäé ÙãÓ ÇäåÊÚêÑÇʬ êÌÈ <emphasis>ÃäÇ</emphasis> ÊÌÙä + ËÇÈÊ åÇ åÓÈèâÇë Èà <literal>$</literal>. + êåãæã ÇÓÊÎÏÇå ÇäÏÇäÉ <function>constant</function> + ÈâÑÇÁÉ âêåÉ ËÇÈÊ ÇÐÇ ãæÊ ÊÑÚÈ áê ÇäÍÕèä Ùäé ÇÓå ÇäËÇÈÊ + ÈÔãä Íêèêñ. + ÇÓÊÎÏå <function>get_defined_constants</function> ääÍÕèä Ùäé äÇÆÍÉ + ãÇáÉ ÇäËèÇÈÊ ÇäåïÙîÑñîáîÉ. + </simpara> + <note> + <simpara> + ÇäËèÇÈÊ èÇäåÊÚêÑÇÊ (ÇäÔÇåäÉ) ÊâÙ áê åÓÇÍÇÊ ÅÓåêñÉ åÎÊäáÉ. + èêâÊÖê çÐÇ ÖåæêÇ èÙäé ÓÈêä ÇäåËÇä Ãæ &true; è + <varname>$TRUE</varname> åÇ ÙåèåÇë åÎÊäáÇæ. + </simpara> + </note> + <simpara> + ÅÐÇ ãæÊ ÊÓÊÎÏå ËÇÈÊÇë ÚêÑ åïÙîÑñîᬠáÅæ PHP ÓêáÊÑÖ Ãæñã ÊâÕÏ + ÇÓå ÇäËÇÈÊ æáÓç ÊÍÏêÏÇë åËäåÇ äè Ãæã æÇÏêÊç Ùäé Ãæñç + <type>string</type> (CONSTANT vs "CONSTANT"). èÙæÏåÇ ê×Ñà çÐǬ áÅæ Î×Ã åæ åÓÊèé + <link linkend="ref.errorfunc">E_NOTICE</link> ÓêÊå ÇÓÊÕÏÇÑç. + ÇÓÊÙÑÖ ÃêÖÇ åÏÎä ÇäÏñäêä áêåÇ êçÕ ÇäÓÈÈ ÇäÐê êÌÙä + <link linkend="language.types.array.foo-bar">$foo[bar]</link> + ÎÇׯÇë (ÅäÇ ÅÐÇ ÇÓÊÈâÊ ÇäÃåÑ ÈÅÊåÇå <function>define</function> + <literal>bar</literal> Ùäé Ãæç ËÇÈÊ). ÅÐÇ ãæÊ ÊÑêÏ áâ× ÊáâÏ Åæ + ãÇæ ËÇÈÊ åÇ åÍÏÏ Çäâêåɬ áÇÓÊÎÏå ÏÇäÉ <function>defined</function>. + </simpara> + <para> + çÐç çê ÇäÇÎÊäÇáÇÊ Èêæ ÇäËèÇÈÊ èÇäåÊÚêÑÇÊ: + <itemizedlist> + <listitem> + <simpara> + ÇäËèÇÈÊ äêÓÊ äÏêçÇ ÙäÇåÉ ÏèäÇÑ (<literal>$</literal>) + áê åâÏåÊçÇ» + </simpara> + </listitem> + <listitem> + <simpara> + ÇäËèÇÈÊ êåãæ ÊÙÑêáçÇ áâ× åæ ÎäÇä ÇäÏÇäÉ + <function>define</function>¬ èäêÓ Ùæ ×Ñêâ ÊÙêêæ ÈÓê×» + </simpara> + </listitem> + <listitem> + <simpara> + ÇäËèÇÈÊ êåãæ ÊÙÑêáçÇ èèäèÌçÇ áê Ãê åãÇæ ÈÚÖ ÇäæñØÑ + Ùæ âèÇÙÏ ÊÓêêÑ åÏé ÇäåÊÚêÑÇÊ» + </simpara> + </listitem> + <listitem> + <simpara> + ÇäËèÇÈÊ äÇ êåãæ ÅÙÇÏÉ Ãè ÅÒÇäÉ ÊÙÑêáçÇ èÐäã ÈåÌÑÏ Ãæ êÊå + ÊÍÏêÏ âêåÊçÇ» ãÐä㬠áÅæ + </simpara> + </listitem> + <listitem> + <simpara> + ÇäËèÇÈÊ êåãæ áâ× ÊâêêåçÇ Èâêå ÃÍÇÏêñÉ. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + <example> + <title>ÊÙÑêá ÇäËèÇÈÊ</title> + <programlisting role="php"><![CDATA[ +<?php +define("CONSTANT", "ÃçäÇ êÇ ÙÇäå."); +echo CONSTANT; // êïØçðÑ "ÃçäÇ êÇ ÙÇäå." +echo Constant; // êïØçðÑ "Constant" èêïÕòÏðÑ ÊæÈêçÇë. +?> +]]></programlisting> + </example> + </para> + </sect1> + <sect1 id="language.constants.predefined"> + <title>ÇäËèÇÈÊ ÇäåïÙîÑñîáîÉ åÓÈâÇë</title> + <simpara> + ÊïèîáðÑï PHP ÙÏÏÇë èÇÓÙÇ åæ ÇäËèÇÈÊ ÇäåïÙîÑñîáîÉ åÓÈâÇë äÃê ÎÇ×è× + Êâèå ÈÊÔÚêäç. åÙ Ðä㬠áÅæñ ÇäÙÏêÏ åæ çÐç ÇäËèÇÈÊ ÊïæòÔîà ÙåèåÇë + åæ ×Ñá ÊèÓÙÇÊ åÊæèÙÉ èÓÊãèæ ÍÇÖÑÉ áâ× ÙæÏåÇ Êãèæ Êäã ÇäÊèÓÙÇÊ + åÊèáÑÉ ÅåÇ åæ ÎäÇä ÇäÊñÙÈÆÉ ÇäÍêèêñÉ Ãè äÓÈÈ Ãæñç + Êå ÊÖåêæçÇ ÙæÏ ÇäÊñÌåêÙ. + </simpara> + <para> + çæÇã ËèÇÈÊ ÓÍÑêñÉ ÃÑÈÙÉ ÊÊÚêÑ ÈÍÓÈ + åãÇæ ÇÓÊÎÏÇåçÇ. Ùäé ÓÈêä ÇäåËÇä¬ áÅæñ âêåÉ + <constant>__LINE__</constant> ÊÑÊÈ× ÈÇäÓñ×Ñ ÇäåÓÊÙåä + Èç Öåæ ÎÇ×è×ã. çÐç ÇäËèÇÈÊ ÇäÎÇÕÉ ÊÊÓå ÈãèæçÇ + åÊÍÓÓÉ äÍÇäÉ ÇäÃÍÑá èçê ãåÇ êäê: + </para> + <para> + <table> + <title>ÈÙÖ ËèÇÈÊ PHP "ÇäÓñðÍÑêñÉ"</title> + <tgroup cols="2"> + <thead> + <row> + <entry>ÇäÅÓå</entry> + <entry>ÇäèÕá</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <constant>__LINE__</constant> + </entry> + <entry> + Ñâå ÇäÓñ×Ñ ÇäÍÇäêñ ÇäÎÇÕ ÈÇäåäá. + </entry> + </row> + <row> + <entry> + <constant>__FILE__</constant> + </entry> + <entry> + ÇäåÓÇÑ ÇäãÇåä èÇÓå Çäåäá ÇäÎÇÕ ÈÇäåäá. + </entry> + </row> + <row> + <entry> + <constant>__FUNCTION__</constant> + </entry> + <entry> + ÇÓå ÇäÏÇäÉ. (ÃïÖðêá çÐÇ áê PHP 4.3.0.) + </entry> + </row> + <row> + <entry> + <constant>__CLASS__</constant> + </entry> + <entry> + ÇÓå ÇäÕñðæá. (ÃïÖðêá çÐÇ áê PHP 4.3.0.) + </entry> + </row> + <row> + <entry> + <constant>__METHOD__</constant> + </entry> + <entry> + ÇÓå åæçÌ ÇäÕñðæá. (ÃïÖðêá çÐÇ áê PHP 5.0.0) + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <simpara> + ÊÊèáÑ äÇÆÍÉ ÈÇäËèÇÈÊ ÇäåïÙîÑñîáÉ åÓÈâÇë áê áÕä <link linkend="reserved.constants">ÇäËèÇÈÊ ÇäåïÙîÑñîáÉ åÓÈâÇë èÇäåÍÌèÒÉ</link>. + </simpara> + </sect1> +</chapter> +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + +
Index: phpdoc-ar/language/constants.xml diff -u phpdoc-ar/language/constants.xml:1.1 phpdoc-ar/language/constants.xml:1.2 --- phpdoc-ar/language/constants.xml:1.1 Mon Mar 25 13:09:48 2002 +++ phpdoc-ar/language/constants.xml Fri Aug 29 14:53:17 2003 @@ -1,115 +1,218 @@ -<?xml version="1.0" encoding="iso-8859-6"?> -<!-- $EN-Revision: 1.24 $ --> - <chapter id="language.constants"> - <title>ÇäËèÇÈÊ</title> - - <simpara> ÇäËÇÈÊ çè ÑåÒ åÙÑñá äâêåÉ åǬ -èãåÇ çè èÇÖÍ åæ ÇäÊÓåêÉ áÅæ ÇäâêåÉ äÇ êåãæ Ãæ ÊÊÚêÑ ÎäÇä ÊæáêÐ ÇäÈÑæÇåÌ. - ('ÇäËèÇÈÊ ÇäååêÒÉ' <constant>__FILE__</constant> è <constant>__LINE__</constant> ÊÈÏè ÇÓÊËæÇÁ äçÐç ÇäâÇÙÏɬ -äãæçÇ äêÓÊ ËèÇÈÊ áÙäêÇë.) -ÇäËÇÈÊ êÊÃËÑ ÈÍÇäÉ ÇäÍÑèá ÇäÕÚêÑÉ èÇäãÈêÑÉ ÇáÊÑÇÖêÇë. èâÏ ÌÑÊ ÇäÙÇÏÉ Ãæ Êãèæ ÇäËèÇÈÊ ÏÇÆåÇë ÈÃÍÑá ãÈêÑÉ . -</simpara> - <para> ÇÓå ÇäËÇÈÊ êÊÈÙ æáÓ ÇäÔÑè× äÃê ÊÓåêÉ áê äÚÉ ÇäÈê ÅÊÔ Èê. -ÇäÇÓå ÇäÕÍêÍ ääËÇÈÊ êÈÏà ÈÍÑá Ãè ÔÑ×É Óáäêɬ åÊÈèÙÉ ÈÃê ÙÏÏ åæ ÇäÍÑèᬠÇäÃÑâÇå Ãè ÇäÔÑ× ÇäÓáäêÉ . èÈÊÙÈêÑ âêÇÓê êåãæ ÊåËêä âÇÙÏÉ ÇÓå ÇäËÇÈÊ çãÐÇ :<literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal> - - <!-- TODO: Example of valid & invalid constant names --> - </para> - - <note> - <simpara> çæÇ ÓæÙÊÈÑ ÇäÍÑá çè ÃÍÏ ÇäÍÑèá ÇäçÌÇÆêÉ ÇäÇæÌäêÒêÉ a-z è A-Z èÑåèÒ ASCII ÐÇÊ ÇäâêåÉ åæ 127 èÍÊé 255 (Ox7f-Oxff). -</simpara> - </note> - - <simpara> åÏé (æ×Çâ) ÇÓÊÎÏÇå ÇäËÇÈÊ åÏéë ÔÇåä¬ ÍêË ÊÓÊ×êÙ ÇäèÕèä Åäêç åæ Ãê åãÇæ ÏÇÎä ÈÑæÇåÌã Ïèæ ÇçÊåÇå ääåÏé.</simpara> - - <sect1 id="language.constants.syntax"> - <title>ÇäÕêÚÉ</title> - <simpara> ÊÓÊ×êÙ Ãæ ÊÙÑá ËÇÈÊÇë ÈÇÓÊÎÏÇå ÏÇäÉ <function>define</function>. ÍêæåÇ êÊå ÊÙÑêá ÇäËÇÈÊ äÇ êåãæ ÙæÏÆÐ Ãæ êÊÚêÑ Ãè êÒÇä ÊÙÑêáç. -</simpara> - <simpara> ÇäÈêÇæÇÊ ÇäâêÇÓêÉ áâ× (<type>boolean</type>, <type>integer</type>, - <type>double</type> è <type>string</type>) êåãæ ÇÓÊÎÏÇåçÇ áê ÇäËèÇÈÊ. - </simpara> - <simpara> ÊÓÊ×êÙ ÇäÍÕèä Ùäé âêåÉ Ãê ËÇÈÊ Ùæ ×Ñêâ ÊÍÏêÏ ÇÓåç ÈÈÓÇ×ç. - Ùäé ÙãÓ ÇäåÊÚêÑÇʬ êÌÈ Ãæ <emphasis>äÇ</emphasis> ÊÓÈâ ÇäËÇÈÊ ÈÙäÇåÉ<literal>$</literal> -. ÊÓÊ×êÙ ÇÓÊÎÏÇå ÇäÏÇäÉ <function>constant</function>¬ äâÑÇÁÉ âêåÉ ÇäËÇÈʬ ÇÐÇ ãæÊ ÊÑÚÈ áê ÇÓÊÎÏÇå ÇÓå ÇäËÇÈÊ ÏêæÇåêãêÇë. - ÊÓÊ×êÙ ÇêÖÇë ÇÓÊÎÏÇå <function>get_defined_constants</function> ääÍÕèä Ùäé âÇÆåÉ Èãä ÇäËèÇÈÊ ÇäåÙÑáÉ . - </simpara> - <note> - <simpara> ÇäËèÇÈÊ è ÇäåÊÚêÑÇÊ (ÇäÔÇåäÉ) ÊâÙ áê åèÇâÙ åÎÊäáɬ ååÇ êæÊÌ Ùæ Ðäã åËäÇë ãèæ &true; è - <varname>$TRUE</varname> åÎÊäáÇæ ÊåÇåÇë.</simpara> - </note> - <simpara> - ÙæÏåÇ ÊÓÊÎÏå ËÇÈÊÇë ÚêÑ åÙÑᬠáÓêáÊÑÖ PHP Ãæã ÊÙæê ÇÓÊÎÏÇå ÇÓå ÇäËÇÈÊ æáÓç èäêÓ ÇäâêåÉ. -Óèá êÕÏÑ <link linkend="features.error-handling">ÊæÈêç</link> ÙæÏåÇ ÊÍÏË åËä çÐç ÇäÍÇäÉ. äÐäã êåãæã ÇÓÊÎÏÇå ÇäÏÇäÉ <function>defined</function> ÇÐÇ ÃÑÏÊ Ãæ ÊÙÑá åÇ ÅÐÇ ãÇæ ÇäËÇÈÊ âÏ Êå ÊÙÑêáç.</simpara> - <para> çÐç çê ÇäÇÎÊäÇáÇÊ Èêæ ÇäËèÇÈÊ èÇäåÊÚêÑÇÊ : - <itemizedlist> - <listitem> - <simpara> ÇäËèÇÈÊ äÇ ÊÓÊÎÏå ÙäÇåÉ ÇäÏèäÇÑ (<literal>$</literal>) âÈäçÇ» </simpara> - </listitem> - <listitem> - <simpara> ÇäËèÇÈÊ êåãæ Ãæ êÊå ÊÙÑêáçÇ áâ× åæ ÎäÇä ÇäÏÇäÉ <function>define</function>, èäêÓ Ùæ ×Ñêâ ÊÙêêæ ÈÓê×; </simpara> - </listitem> - <listitem> - <simpara> ÇäËèÇÈÊ êåãæ ÊÙÑêáçÇ èÊÎÕêÕçÇ áê Ãê åãÇæ Ïèæ ÇäÇçÊåÇå ÈÔÑè× åÏé ÇäåÊÚêÑÇÊ» </simpara> - </listitem> - <listitem> - <simpara> ÇäËèÇÈÊ äÇ êåãæ ÅÙÇÏÉ ÊÙÑêáçÇ Ãè ÅÒÇäÉ ÊÙÑêáçǬ ÙæÏåÇ êÊå ÊÙÑêáçÇ åÑÉ ÊÕÈÍ åÙêæÉ ÈÔãä æçÇÆê» - </simpara> - </listitem> - <listitem> - <simpara> ÇäËèÇÈÊ êåãæ Ãæ ÊâÏÑ Èâêå âêÇÓêÉ áâ×.</simpara> - </listitem> - </itemizedlist> - </para> - - <para> - <example> - <title>ÊÙÑêá ÇäËèÇÈÊ</title> - <programlisting role="php"> -<![CDATA[ -<?php -define("CONSTANT", "Hello world."); -echo CONSTANT; // outputs "Hello world." -echo Constant; // outputs "Constant" and issues a notice. -?>]]> - </programlisting> - </example> - - </para> - </sect1> - - <sect1 id="language.constants.predefined"> - <title>ÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë</title> - - <simpara> ÊÒèÏ PHP ÙÏÏÇë ãÈêÑÇë åæ ÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë äÃê ÈÑæÇåÌ êæáÐ. - ÇäÙÏêÏ åæ çÐç ÇäËèÇÈÊ ÙåèåÇë ÊæÔà ÈèÇÓ×É ÇäÙÏêÏ åæ ÇäÇåÊÏÇÏÇÊ (extensions)¬ èÊãèæ ÍÇÖÑÉ ÙæÏåÇ Êãèæ çÐç ÇäÇåÊÏÇÏÇÊ åÊèáÑÉ áâ׬ ÅåÇ ÙÈÑ ÊÍåêäçÇ ÏêæÇåêãêÇë Ãè Ãæ Êãèæ åÏåÌÉ ÃËæÇÁ ÇäÊÑãêÈ. -</simpara> - - <simpara> âÇÆåÉ ÈÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë åèÌèÏÉ áê çÐÇ ÇäâÓå <link - linkend="reserved.constants">ÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë</link> -. </simpara> - - - </sect1> - </chapter> - -<!-- Keep this comment at the end of the file -Local variables: -mode: sgml -sgml-omittag:t -sgml-shorttag:t -sgml-minimize-attributes:nil -sgml-always-quote-attributes:t -sgml-indent-step:1 -sgml-indent-data:t -indent-tabs-mode:nil -sgml-parent-document:nil -sgml-default-dtd-file:"../../manual.ced" -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: -vim600: syn=xml fen fdm=syntax fdl=2 si -vim: et tw=78 syn=sgml -vi: ts=1 sw=1 ---> +<?xml version="1.0" encoding="ISO-8859-6"?> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.34 Maintainer: visualmind Status: ready --> +<chapter id="language.constants"> + <title>ÇäËèÇÈÊ</title> + <simpara> + ÇäËÇÈÊ çè åïÙîÑñðá (ÅÓå) äâêåÉ ÈÓê×É. èãåÇ ÊèÍê Åäêç ÇäÊñÓåêɬ + áÅæñ çÐç ÇäâêåÉ äÇ êåãæ Ãæ ÊÊÚêÑ ÎäÇä ÊæáêÐ + ÇäÎÇ×è× (ÈÇÓÊËæÇÁ åÇ êÎÕ <link linkend="language.constants.predefined"> + ÇäËèÇÈÊ ÇäÓñðÍÑêñÉ</link> ÇäÊê äÇ ÊïÙîÏï ÍÇäêÇ Ùäé ÃæñçÇ ËèÇÈÊ). + êÊÓå ÇäËÇÈË Èãèæç åïÊîÍîÓñðÓ äÍÇäÉ ÇäÃÍÑá èÐäã ÈÔãä ÇáÊÑÇÖê. èâÏ ÏÑÌÊ ÇäÙÇÏÉ Ãæ Êãèæ åïÙÑñðáÇÊ ÇäËÇÈÊ + ÏèåÇ ÈÃÍÑá ãÈêÑÉ. + </simpara> + <para> + êÊÈÙ ÅÓå ÇäËÇÈÊ æáÓ âèÇÙÏ ÃêÉ ÊÓåêÉ áê PHP. + ÅÓå ËÇÈÊ ÕÇäÍ êÈÏà ÈÍÑá Ãè ÔÑ×É Óáäêñɬ åÊÈèÙÇ + ÈÃê ÙÏÏ åæ ÇäÍÑèᬠÇäÃÑâÇå Ãè ÇäÔñÑ×ÇÊ ÇäÓñáäêñÉ. èãÙÈÇÑÉ ÇÙÊêÇÏêñɬ + ÓêÊå ÇäÊÙÈêÑ ÙæçÇ çãÐÇ: + <literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal> + <!-- TODO: Example of valid & invalid constant names --> + </para> + <note> + <simpara> + áê åÙÑÖ çÐǬ áÅæñ ÇäÍÑá êÊåËä áê a-z¬ A-Z áê Íêæ ÊåÊÏ ÍÑèá ASCII + åæ 127 Åäé ÚÇêÉ 255 (0x7f-0xff). + </simpara> + </note> + <simpara> + åËä &link.superglobals;¬ áÅæñ ÇäåÏé ÇäÎÇÕ ÈËÇÈÊí åÇ êÊÓå Èãèæç ÔÇåäÇë. + êåãæã èäèÌ ÇäËèÇÈÊ ÈÃê åãÇæ áê ÎÇ×è×ã ÈÚÖ ÇäæØÑ Ùæ ÇäåÏé. + äåÒêÏ åæ ÇäåÙäèåÇÊ ÈÎÕèÕ ÇäåÏé¬ ÇâÑà áÕä ÇäÏñäêä ÇäåÊÙäâ Èà + <link linkend="language.variables.scope">åÏé ÇäåÊÚêÑÇÊ</link>. + </simpara> + <sect1 id="language.constants.syntax"> + <title>ÇäÕñêÚÉ</title> + <simpara> + êåãæã ÊÙÑêá ËÇÈÊ ÈÇÓÊÎÏÇå ÏÇäÉ + <function>define</function>. ÈåÌÑÏ ÊÙÑêá ÊÙÑêá ÇäËÇÈʬ + êÕÈÍ åÓÊÙÕêÇ èääÃÈÏ ÊÚêêÑç Ãè ÅÒÇäÉ ÊÙÑêáç. + </simpara> + <simpara> + áâ× ÇäÈêÇæÇÊ ÇäÃÍÇÏêñÉ ÇäâêåÉ (<type>boolean</type>¬ <type>integer</type>¬ + <type>float</type> è <type>string</type>) êåãæ ÊÖåêæçÇ + áê ËèÇÈÊ. + </simpara> + <simpara> + êåãæã ÇäÍÕèä Ùäé âêåÉ ËÇÈʬ ÈÈÓÇ×ɬ Ùæ ×Ñêâ ÊÍÏêÏ ÇÓåç. + Ùäé ÙãÓ ÇäåÊÚêÑÇʬ êÌÈ <emphasis>ÃäÇ</emphasis> ÊÌÙä + ËÇÈÊ åÇ åÓÈèâÇë Èà <literal>$</literal>. + êåãæã ÇÓÊÎÏÇå ÇäÏÇäÉ <function>constant</function> + ÈâÑÇÁÉ âêåÉ ËÇÈÊ ÇÐÇ ãæÊ ÊÑÚÈ áê ÇäÍÕèä Ùäé ÇÓå ÇäËÇÈÊ + ÈÔãä Íêèêñ. + ÇÓÊÎÏå <function>get_defined_constants</function> ääÍÕèä Ùäé äÇÆÍÉ + ãÇáÉ ÇäËèÇÈÊ ÇäåïÙîÑñîáîÉ. + </simpara> + <note> + <simpara> + ÇäËèÇÈÊ èÇäåÊÚêÑÇÊ (ÇäÔÇåäÉ) ÊâÙ áê åÓÇÍÇÊ ÅÓåêñÉ åÎÊäáÉ. + èêâÊÖê çÐÇ ÖåæêÇ èÙäé ÓÈêä ÇäåËÇä Ãæ &true; è + <varname>$TRUE</varname> åÇ ÙåèåÇë åÎÊäáÇæ. + </simpara> + </note> + <simpara> + ÅÐÇ ãæÊ ÊÓÊÎÏå ËÇÈÊÇë ÚêÑ åïÙîÑñîᬠáÅæ PHP ÓêáÊÑÖ Ãæñã ÊâÕÏ + ÇÓå ÇäËÇÈÊ æáÓç ÊÍÏêÏÇë åËäåÇ äè Ãæã æÇÏêÊç Ùäé Ãæñç + <type>string</type> (CONSTANT vs "CONSTANT"). èÙæÏåÇ ê×Ñà çÐǬ áÅæ Î×Ã åæ åÓÊèé + <link linkend="ref.errorfunc">E_NOTICE</link> ÓêÊå ÇÓÊÕÏÇÑç. + ÇÓÊÙÑÖ ÃêÖÇ åÏÎä ÇäÏñäêä áêåÇ êçÕ ÇäÓÈÈ ÇäÐê êÌÙä + <link linkend="language.types.array.foo-bar">$foo[bar]</link> + ÎÇׯÇë (ÅäÇ ÅÐÇ ÇÓÊÈâÊ ÇäÃåÑ ÈÅÊåÇå <function>define</function> + <literal>bar</literal> Ùäé Ãæç ËÇÈÊ). ÅÐÇ ãæÊ ÊÑêÏ áâ× ÊáâÏ Åæ + ãÇæ ËÇÈÊ åÇ åÍÏÏ Çäâêåɬ áÇÓÊÎÏå ÏÇäÉ <function>defined</function>. + </simpara> + <para> + çÐç çê ÇäÇÎÊäÇáÇÊ Èêæ ÇäËèÇÈÊ èÇäåÊÚêÑÇÊ: + <itemizedlist> + <listitem> + <simpara> + ÇäËèÇÈÊ äêÓÊ äÏêçÇ ÙäÇåÉ ÏèäÇÑ (<literal>$</literal>) + áê åâÏåÊçÇ» + </simpara> + </listitem> + <listitem> + <simpara> + ÇäËèÇÈÊ êåãæ ÊÙÑêáçÇ áâ× åæ ÎäÇä ÇäÏÇäÉ + <function>define</function>¬ èäêÓ Ùæ ×Ñêâ ÊÙêêæ ÈÓê×» + </simpara> + </listitem> + <listitem> + <simpara> + ÇäËèÇÈÊ êåãæ ÊÙÑêáçÇ èèäèÌçÇ áê Ãê åãÇæ ÈÚÖ ÇäæñØÑ + Ùæ âèÇÙÏ ÊÓêêÑ åÏé ÇäåÊÚêÑÇÊ» + </simpara> + </listitem> + <listitem> + <simpara> + ÇäËèÇÈÊ äÇ êåãæ ÅÙÇÏÉ Ãè ÅÒÇäÉ ÊÙÑêáçÇ èÐäã ÈåÌÑÏ Ãæ êÊå + ÊÍÏêÏ âêåÊçÇ» ãÐä㬠áÅæ + </simpara> + </listitem> + <listitem> + <simpara> + ÇäËèÇÈÊ êåãæ áâ× ÊâêêåçÇ Èâêå ÃÍÇÏêñÉ. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + <example> + <title>ÊÙÑêá ÇäËèÇÈÊ</title> + <programlisting role="php"><![CDATA[ +<?php +define("CONSTANT", "ÃçäÇ êÇ ÙÇäå."); +echo CONSTANT; // êïØçðÑ "ÃçäÇ êÇ ÙÇäå." +echo Constant; // êïØçðÑ "Constant" èêïÕòÏðÑ ÊæÈêçÇë. +?> +]]></programlisting> + </example> + </para> + </sect1> + <sect1 id="language.constants.predefined"> + <title>ÇäËèÇÈÊ ÇäåïÙîÑñîáîÉ åÓÈâÇë</title> + <simpara> + ÊïèîáðÑï PHP ÙÏÏÇë èÇÓÙÇ åæ ÇäËèÇÈÊ ÇäåïÙîÑñîáîÉ åÓÈâÇë äÃê ÎÇ×è× + Êâèå ÈÊÔÚêäç. åÙ Ðä㬠áÅæñ ÇäÙÏêÏ åæ çÐç ÇäËèÇÈÊ ÊïæòÔîà ÙåèåÇë + åæ ×Ñá ÊèÓÙÇÊ åÊæèÙÉ èÓÊãèæ ÍÇÖÑÉ áâ× ÙæÏåÇ Êãèæ Êäã ÇäÊèÓÙÇÊ + åÊèáÑÉ ÅåÇ åæ ÎäÇä ÇäÊñÙÈÆÉ ÇäÍêèêñÉ Ãè äÓÈÈ Ãæñç + Êå ÊÖåêæçÇ ÙæÏ ÇäÊñÌåêÙ. + </simpara> + <para> + çæÇã ËèÇÈÊ ÓÍÑêñÉ ÃÑÈÙÉ ÊÊÚêÑ ÈÍÓÈ + åãÇæ ÇÓÊÎÏÇåçÇ. Ùäé ÓÈêä ÇäåËÇä¬ áÅæñ âêåÉ + <constant>__LINE__</constant> ÊÑÊÈ× ÈÇäÓñ×Ñ ÇäåÓÊÙåä + Èç Öåæ ÎÇ×è×ã. çÐç ÇäËèÇÈÊ ÇäÎÇÕÉ ÊÊÓå ÈãèæçÇ + åÊÍÓÓÉ äÍÇäÉ ÇäÃÍÑá èçê ãåÇ êäê: + </para> + <para> + <table> + <title>ÈÙÖ ËèÇÈÊ PHP "ÇäÓñðÍÑêñÉ"</title> + <tgroup cols="2"> + <thead> + <row> + <entry>ÇäÅÓå</entry> + <entry>ÇäèÕá</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <constant>__LINE__</constant> + </entry> + <entry> + Ñâå ÇäÓñ×Ñ ÇäÍÇäêñ ÇäÎÇÕ ÈÇäåäá. + </entry> + </row> + <row> + <entry> + <constant>__FILE__</constant> + </entry> + <entry> + ÇäåÓÇÑ ÇäãÇåä èÇÓå Çäåäá ÇäÎÇÕ ÈÇäåäá. + </entry> + </row> + <row> + <entry> + <constant>__FUNCTION__</constant> + </entry> + <entry> + ÇÓå ÇäÏÇäÉ. (ÃïÖðêá çÐÇ áê PHP 4.3.0.) + </entry> + </row> + <row> + <entry> + <constant>__CLASS__</constant> + </entry> + <entry> + ÇÓå ÇäÕñðæá. (ÃïÖðêá çÐÇ áê PHP 4.3.0.) + </entry> + </row> + <row> + <entry> + <constant>__METHOD__</constant> + </entry> + <entry> + ÇÓå åæçÌ ÇäÕñðæá. (ÃïÖðêá çÐÇ áê PHP 5.0.0) + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <simpara> + ÊÊèáÑ äÇÆÍÉ ÈÇäËèÇÈÊ ÇäåïÙîÑñîáÉ åÓÈâÇë áê áÕä <link linkend="reserved.constants">ÇäËèÇÈÊ ÇäåïÙîÑñîáÉ åÓÈâÇë èÇäåÍÌèÒÉ</link>. + </simpara> + </sect1> +</chapter> +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + +