cvs: phpdoc-ar /language types.xml

From: Date: Mon, 01 Sep 2003 20:59:39 +0000
Subject: cvs: phpdoc-ar /language types.xml
Groups: php.doc.ar 
Request: Send a blank email to doc-ar+get-567@lists.php.net to get a copy of this message
hafid Mon Sep 1 16:59:39 2003 EDT Modified files: /phpdoc-ar/language types.xml Log: 2nd Partial Translation. 1.123 compliant

Index: phpdoc-ar/language/types.xml diff -u phpdoc-ar/language/types.xml:1.1 phpdoc-ar/language/types.xml:1.2 --- phpdoc-ar/language/types.xml:1.1 Sun Aug 31 16:09:24 2003 +++ phpdoc-ar/language/types.xml Mon Sep 1 16:59:39 2003 @@ -1,60 +1,60 @@ -<?xml version="1.0" encoding="WINDOWS-1256"?> -<!-- $Revision: 1.1 $ --> +<?xml version="1.0" encoding="ISO-8859-6"?> +<!-- $Revision: 1.2 $ --> <!-- EN-Revision: 1.123 Maintainer: hafid Status: ready --> <chapter id="language.types"> - <title>ÇáÃäæÇÚ</title> + <title>ÇäÃæèÇÙ</title> <sect1 id="language.types.intro"> - <title>ãÞÏãÉ</title> + <title>åâÏåÉ</title> <simpara> - ÊÏÚã PHP ËãÇäíÉ ÃäæÇÚ ÈÏÇÆíøÉ. + ÊÏÙå PHP ËåÇæêÉ ÃæèÇÙ ÈÏÇÆêñÉ. </simpara> <para> - ÃÑÈÚÉ ÃäæÇÚ ÃÍÇÏíÉ ÇáÞíãÉ: + ÃÑÈÙÉ ÃæèÇÙ ÃÍÇÏêÉ ÇäâêåÉ: <itemizedlist> <listitem> <simpara> - <type>boolean - ãäØÞí</type> + <type>boolean - åæ×âê</type> </simpara> </listitem> <listitem> <simpara> - <type>integer - ÚÏÏ ÕÍíÍ</type> + <type>integer - ÙÏÏ ÕÍêÍ</type> </simpara> </listitem> <listitem> <simpara> - <type>float - ÚÇÆã</type> (ÚÏÏ Ðí äÞØÉ ÚÇÆãÉ floating-point number¡ Ãæ '<type>double - ãÒÏæÌ</type>') + <type>float - ÙÇÆå</type> (ÙÏÏ Ðê æâ×É ÙÇÆåÉ floating-point number¬ Ãè '<type>double - åÒÏèÌ</type>') </simpara> </listitem> <listitem> <simpara> - <type>string - ÓáÓáÉ äÕíøÉ</type> + <type>string - ÓäÓäÉ æÕêñÉ</type> </simpara> </listitem> </itemizedlist> - äæÚíä ãõÑóßøóÈóíä: + æèÙêæ åïÑîãñîÈîêæ: <itemizedlist> <listitem> <simpara> - <type>array - ãÕÝæÝÉ</type> + <type>array - åÕáèáÉ</type> </simpara> </listitem> <listitem> <simpara> - <type>object - ßÇÆä</type> + <type>object - ãÇÆæ</type> </simpara> </listitem> </itemizedlist> - æÃÎíÑÇ¡ äæÚíä ÎÇÕíä: + èÃÎêÑǬ æèÙêæ ÎÇÕêæ: <itemizedlist> <listitem> <simpara> - <type>resource - ãæÑÏ</type> + <type>resource - åèÑÏ</type> </simpara> </listitem> <listitem> @@ -64,65 +64,65 @@ </listitem> </itemizedlist> - åÐÇ ÇáÏøáíá íãåÏ ÃíÖÇ áÈÚÖ - <link linkend="language.pseudo-types">ÃÔÈÇå-ÇáÃäæÇÚ</link> - æÐáß áÃÛÑÇÖ ÊÊÚáÞ ÈÇáãÞÑæÆíÉ: + çÐÇ ÇäÏñäêä êåçÏ ÃêÖÇ äÈÙÖ + <link linkend="language.pseudo-types">ÃÔÈÇç-ÇäÃæèÇÙ</link> + èÐäã äÃÚÑÇÖ ÊÊÙäâ ÈÇäåâÑèÆêÉ: <itemizedlist> <listitem> <simpara> - <link linkend="language.types.mixed">mixed - ããÒæÌ</link> + <link linkend="language.types.mixed">mixed - ååÒèÌ</link> </simpara> </listitem> <listitem> <simpara> - <link linkend="language.types.number">number - ÚÏÏ</link> + <link linkend="language.types.number">number - ÙÏÏ</link> </simpara> </listitem> <listitem> <simpara> - <link linkend="language.types.mixed">callback - ÊÐßíÑ</link> + <link linkend="language.types.mixed">callback - ÊÐãêÑ</link> </simpara> </listitem> </itemizedlist> - íãßäß ÃíÖÇ ÅíÌÇÏ ÈÚÖ ÇáÅÔÇÑÇÊ ááäæÚ "ãÒÏæÌ". ÇÚÊÈÑ - ÇáãÒÏæÌ (double) Úáì Ãäøå äÝÓ ÇáÔíÁ ãËá ÇáÚÇÆã (float)¡ ÇáÅÓãÇä íÊÚÇíÔÇä ÝÞØ áÃÓÈÇÈ - ÊÇÑíÎíøÉ. + êåãæã ÃêÖÇ ÅêÌÇÏ ÈÙÖ ÇäÅÔÇÑÇÊ ääæèÙ "åÒÏèÌ". ÇÙÊÈÑ + ÇäåÒÏèÌ (double) Ùäé Ãæñç æáÓ ÇäÔêÁ åËä ÇäÙÇÆå (float)¬ ÇäÅÓåÇæ êÊÙÇêÔÇæ áâ× äÃÓÈÇÈ + ÊÇÑêÎêñÉ. </para> <simpara> - ÚÇÏÉ¡ áÇ íõÍÏøóÏ äæÚ ãÊÛíÑ ãä ÞÈá ÇáãõÈÑãö̺ - ÚßÓ Ðáß¡ ÝÅäå íÊã ÊÞÑíÑå ÚäÏ Òãä ÇáÊÔÛíá ãä ÞÈá PHP ÈÍÓÈ ÅØÇÑ - ÇÓÊÎÏÇã Ðáß ÇáãÊÛíÑ. + ÙÇÏɬ äÇ êïÍÏñîÏ æèÙ åÊÚêÑ åæ âÈä ÇäåïÈÑåðÌ» + ÙãÓ Ðä㬠áÅæç êÊå ÊâÑêÑç ÙæÏ Òåæ ÇäÊÔÚêä åæ âÈä PHP ÈÍÓÈ Å×ÇÑ + ÇÓÊÎÏÇå Ðäã ÇäåÊÚêÑ. </simpara> <note> <simpara> - ÅÐÇ ÃÑÏÊ ÇáÊÍÞÞ ãä äæÚ æÞíãÉ <link linkend="language.expressions">expression - ÚÈÇÑÉ</link> ãõÍÏøóÏóÉ¡ ÝÇÓÊÎÏã + ÅÐÇ ÃÑÏÊ ÇäÊÍââ åæ æèÙ èâêåÉ <link linkend="language.expressions">expression - ÙÈÇÑÉ</link> åïÍÏñîÏîɬ áÇÓÊÎÏå <function>var_dump</function>. </simpara> <para> - ÅÐÇ ÃÑÏÊ ÝÞØ ÊãËíáÇ ááäæÚ íßæä ÞÇÈáÇ ááÞÑÇÁÉ ãä ÞÈá ÇáÅäÓÇä æÈÛÑÖ - ÅÒÇáÉ ÇáÚöáá¡ ÝÇÓÊÎÏã <function>gettype</function>. áÊÝÞÏ äæÚ ãõÍÏøóÏ¡ - <emphasis>áÇ</emphasis> ÊÓÊÎÏã <function>gettype</function> æÅäøãÇ ÇÓÊÎÏã - ÏæÇá <literal>is_<replaceable>type</replaceable> - </literal>. ÈÚÖ - ÇáÃãËáÉ: + ÅÐÇ ÃÑÏÊ áâ× ÊåËêäÇ ääæèÙ êãèæ âÇÈäÇ ääâÑÇÁÉ åæ âÈä ÇäÅæÓÇæ èÈÚÑÖ + ÅÒÇäÉ ÇäÙðää¬ áÇÓÊÎÏå <function>gettype</function>. äÊáâÏ æèÙ åïÍÏñîϬ + <emphasis>äÇ</emphasis> ÊÓÊÎÏå <function>gettype</function> èÅæñåÇ ÇÓÊÎÏå + ÏèÇä <literal>is_<replaceable>type</replaceable> + </literal>. ÈÙÖ + ÇäÃåËäÉ: <informalexample> <programlisting role="php"><![CDATA[ <?php -$bool = TRUE; // a boolean - ãäØÞí -$str = "foo"; // a string - ÓáÓáÉ äÕíøÉ -$int = 12; // an integer - ÚÏÏ ÕÍíÍ +$bool = TRUE; // a boolean - åæ×âê +$str = "foo"; // a string - ÓäÓäÉ æÕêñÉ +$int = 12; // an integer - ÙÏÏ ÕÍêÍ -echo gettype($bool); // ÊØÈÚ "boolean" -echo gettype($str); // ÊØÈÚ "string" +echo gettype($bool); // Ê×ÈÙ "boolean" +echo gettype($str); // Ê×ÈÙ "string" -// ÅÐÇ ßÇä integer¡ ÝÇÖÝ Åáíå ÈÅáÍÇÞÇÊ ÃÑÈÚÉ +// ÅÐÇ ãÇæ integer¬ áÇÖá Åäêç ÈÅäÍÇâÇÊ ÃÑÈÙÉ if (is_int($int)) { $int += 4; } -// ÅÐÇ ßÇä $bool ÚÈÇÑÉ Úä string¡ ÝÇØÈÚå -// (áÇ íØÈÚ Ãí ÔíÁ) +// ÅÐÇ ãÇæ $bool ÙÈÇÑÉ Ùæ string¬ áÇ×ÈÙç +// (äÇ ê×ÈÙ Ãê ÔêÁ) if (is_string($bool)) { echo "String: $bool"; } @@ -132,64 +132,64 @@ </para> </note> <simpara> - ÅÐÇ ÑÛÈÊ Ýí ÅÌÈÇÑ ãÊÛíÑ áíõÍæøóá Åáì äæÚ - ãõÍÏøóÏ¡ Ýíãßäß ÅãÇ <link linkend="language.types.typecasting">cast - ÊÍæíá</link> ÇáãÊÛíÑ Ãæ - ÇÓÊÎÏÇã ÏÇáÉ <function>settype</function> Úáíå. + ÅÐÇ ÑÚÈÊ áê ÅÌÈÇÑ åÊÚêÑ äêïÍèñîä Åäé æèÙ + åïÍÏñîϬ áêåãæã ÅåÇ <link linkend="language.types.typecasting">cast - ÊÍèêä</link> ÇäåÊÚêÑ Ãè + ÇÓÊÎÏÇå ÏÇäÉ <function>settype</function> Ùäêç. </simpara> <simpara> - ÇäÊÈå Åáì Ãäøå íãßä ÊÞííã ãÊÛíÑ ÈÞíã ãÎÊáÝÉ Ýí æÖÚíÇÊ ãõÍÏøóÏÉ¡ - æÐáß ÈÍÓÈ ÇáäæÚ ÇáÐí íÊÕÝ Èå Ýí ÇáæÞÊ ÇáÑÇåä. áãÒíÏ ãä - ÇáãÚáæãÇÊ¡ ÇÓÊÚÑÖ ÇáÝÕá ÇáãÊÚáÞ ÈÜ <link linkend="language.types.type-juggling">Type Juggling - ÇáÊáÇÚÈ ÈÇáÃäæÇÚ</link>. ßÐáß¡ ÑÈãÇ - Êßæä ãåÊãÇ ÈÅáÞÇÁ äÙÑÉ Úáì - <link linkend="types.comparisons">ÌÏÇæá ãÞÇÑäÉ ÇáÃäæÇÚ</link> - ÈÇÚÊÈÇÑ ÃäåÇ ÊÙåÑ ÃãËáÉ áãÞÇÑäÇÊ ãÊÚáÞÉ ÈÃäæÇÚ ãÊÚÏÏÉ. + ÇæÊÈç Åäé Ãæñç êåãæ Êâêêå åÊÚêÑ Èâêå åÎÊäáÉ áê èÖÙêÇÊ åïÍÏñîÏɬ + èÐäã ÈÍÓÈ ÇäæèÙ ÇäÐê êÊÕá Èç áê ÇäèâÊ ÇäÑÇçæ. äåÒêÏ åæ + ÇäåÙäèåÇʬ ÇÓÊÙÑÖ ÇäáÕä ÇäåÊÙäâ Èà <link linkend="language.types.type-juggling">Type Juggling - ÇäÊäÇÙÈ ÈÇäÃæèÇÙ</link>. ãÐä㬠ÑÈåÇ + Êãèæ åçÊåÇ ÈÅäâÇÁ æØÑÉ Ùäé + <link linkend="types.comparisons">ÌÏÇèä åâÇÑæÉ ÇäÃæèÇÙ</link> + ÈÇÙÊÈÇÑ ÃæçÇ ÊØçÑ ÃåËäÉ äåâÇÑæÇÊ åÊÙäâÉ ÈÃæèÇÙ åÊÙÏÏÉ. </simpara> </sect1> <sect1 id="language.types.boolean"> - <title>Booleans - ÇáãäØÞíÇÊ</title> + <title>Booleans - Çäåæ×âêÇÊ</title> <simpara> - åÐÇ åæ ÇáäæÚ ÇáÃßËÑ ÓåæáÉ. íÚÈÑ <type>boolean</type> Úä - ÞíãÉ ÇáÍÞíÞÉ. íãßä Ãä íßæä &true; Ãæ &false;. + çÐÇ çè ÇäæèÙ ÇäÃãËÑ ÓçèäÉ. êÙÈÑ <type>boolean</type> Ùæ + âêåÉ ÇäÍâêâÉ. êåãæ Ãæ êãèæ &true; Ãè &false;. </simpara> <note> <simpara> - ÃõÏúÑöÌó ÇáäøæÚ ÇáãäØÞíø Ýí PHP 4. + ÃïÏòÑðÌî ÇäæñèÙ Çäåæ×âêñ áê PHP 4. </simpara> </note> <sect2 id="language.types.boolean.syntax"> - <title>ÇáÕíÛÉ</title> + <title>ÇäÕêÚÉ</title> <para> - áÊÍÏíÏ ÍÑÝíÉ ãäØÞíøÉ (boolean literal)¡ ÇÓÊÎÏã ÅãÇ ÇáßáãÉ ÇáãÝÊÇÍíøÉ &true; - Ãæ &false;. ßáÊíåãÇ ãÊÍÓÓÉ áÍÇáÉ ÇáÃÍÑÝ. + äÊÍÏêÏ ÍÑáêÉ åæ×âêñÉ (boolean literal)¬ ÇÓÊÎÏå ÅåÇ ÇäãäåÉ ÇäåáÊÇÍêñÉ &true; + Ãè &false;. ãäÊêçåÇ åÊÍÓÓÉ äÍÇäÉ ÇäÃÍÑá. <informalexample> <programlisting role="php"><![CDATA[ <?php -$foo = True; // ÊÚííä ÇáÞíãÉ TRUE áÜ $foo +$foo = True; // ÊÙêêæ ÇäâêåÉ TRUE äà $foo ?> ]]></programlisting> </informalexample> </para> <para> - Ýí ÇáÚÇÏÉ¡ ÃäÊ - ÊÓÊÎÏã ÈÚÖ ÃäæÇÚ <link linkend="language.operators">ÇáãÚÇãáÇÊ</link> - ããÇ íÄÏí Åáì ÅÑÌÇÚ ÞíãÉ <type>ãäØÞíøÉ</type> æãä Ëã ÊãÑíÑåÇ - Åáì <link linkend="control-structures">ÈäíÉ - ÊÍßãíøÉ</link>. + áê ÇäÙÇÏɬ ÃæÊ + ÊÓÊÎÏå ÈÙÖ ÃæèÇÙ <link linkend="language.operators">ÇäåÙÇåäÇÊ</link> + ååÇ êÄÏê Åäé ÅÑÌÇÙ âêåÉ <type>åæ×âêñÉ</type> èåæ Ëå ÊåÑêÑçÇ + Åäé <link linkend="control-structures">ÈæêÉ + ÊÍãåêñÉ</link>. <informalexample> <programlisting role="php"><![CDATA[ <?php -// == åí ãÚÇãá íÞæã ÈÇÎÊÈÇÑ -// ÇáÊÚÇÏá æíÑÌÚ ãäØÞíÉ +// == çê åÙÇåä êâèå ÈÇÎÊÈÇÑ +// ÇäÊÙÇÏä èêÑÌÙ åæ×âêÉ if ($action == "show_version") { - echo "ÇáÅÕÏÇÑÉ åí 1.23"; + echo "ÇäÅÕÏÇÑÉ çê 1.23"; } -// åÐÇ ÛíÑ ÖÑæÑí... +// çÐÇ ÚêÑ ÖÑèÑê... if ($show_separators == TRUE) { echo "<hr>\n"; } -// ...áÃäøå ÈÇãßÇäß ÈÈÓÇØÉ ÑÞä +// ...äÃæñç ÈÇåãÇæã ÈÈÓÇ×É Ñâæ if ($show_separators) { echo "<hr>\n"; } @@ -199,58 +199,62 @@ </para> </sect2> <sect2 id="language.types.boolean.casting"> - <title>ÇáÊÍæíá Åáì ãäØÞíÉ</title> + <title>ÇäÊÍèêä Åäé åæ×âêÉ</title> <simpara> - áÊÍæíá ÞíãÉ Åáì <type>ãäØÞíÉ</type> æÐáß ÈÔßá ÕÑíÍ¡ ÇÓÊÎÏã ÅãÇ - ÊÍæíá <literal>(bool)</literal> Ãæ ÊÍæíá <literal>(boolean)</literal>. - ãÚ Ðáß¡ æÝí ãÚÙã ÇáÍÇáÇÊ¡ ÝÅäß áÇ ÊÍÊÇÌ áÇÓÊÎÏÇã ÇáÊÍæíá¡ ÅäØáÇÞÇ ãä Ãä ÞíãÉ ãÇ - ÓíÊã ÊÍæíáåÇ ÊáÞÇÆíÇ ÅÐÇ ãÇ ÇÞÊÖì ãÚÇãá¡ ÏÇáÉ Ãæ - ÈäíÉ ÊÍßãíÉ ãÄÔÑÇ <type>ãäØÞíÇð</type>. + äÊÍèêä âêåÉ Åäé <type>åæ×âêÉ</type> èÐäã ÈÔãä ÕÑêͬ ÇÓÊÎÏå ÅåÇ + ÊÍèêä <literal>(bool)</literal> Ãè ÊÍèêä <literal>(boolean)</literal>. + åÙ Ðä㬠èáê åÙØå ÇäÍÇäÇʬ áÅæã äÇ ÊÍÊÇÌ äÇÓÊÎÏÇå ÇäÊÍèêä¬ Åæ×äÇâÇ åæ Ãæ âêåÉ åÇ + ÓêÊå ÊÍèêäçÇ ÊäâÇÆêÇ ÅÐÇ åÇ ÇâÊÖé åÙÇåä¬ ÏÇäÉ Ãè + ÈæêÉ ÊÍãåêÉ åÄÔÑÇ <type>åæ×âêÇë</type>. </simpara> <simpara> - ÇÓÊÚÑÖ ÃíÖÇ <link linkend="language.types.type-juggling">ÇáÊáÇÚÈ ÈÇáÃäæÇÚ</link>. + ÇÓÊÙÑÖ ÃêÖÇ <link linkend="language.types.type-juggling">ÇäÊäÇÙÈ ÈÇäÃæèÇÙ</link>. </simpara> <para> - ÚäÏ ÇáÊÍæíá Åáì <type>ãäØÞíÉ</type>¡ ÝÅä ÇáÞíã ÇáÊÇáíÉ - ÓÊõÚøóÏ &false;: + ÙæÏ ÇäÊÍèêä Åäé <type>åæ×âêÉ</type>¬ áÅæ Çäâêå ÇäÊÇäêÉ + ÓÊïÙñîÏ &false;: <itemizedlist> <listitem> - <simpara><link linkend="language.types.boolean">ÇáãäØÞíÉ</link> - &false; äÝÓåÇ</simpara> + <simpara> + <link linkend="language.types.boolean">Çäåæ×âêÉ</link> + &false; æáÓçÇ</simpara> </listitem> <listitem> - <simpara><link linkend="language.types.integer">ÇáÚÏÏ ÇáÕøÍíÍ</link> 0 (ÕÝÑ) </simpara> + <simpara> + <link linkend="language.types.integer">ÇäÙÏÏ ÇäÕñÍêÍ</link> 0 (ÕáÑ) </simpara> </listitem> <listitem> - <simpara>the <link linkend="language.types.float">ÇáÚÇÆã</link> - 0.0 (ÕÝÑ) </simpara> + <simpara>the <link linkend="language.types.float">ÇäÙÇÆå</link> + 0.0 (ÕáÑ) </simpara> </listitem> <listitem> - <simpara><link linkend="language.types.string">ÇáÓáÓáÉ ÇáäÕíÉ</link> ÇáÝÇÑÛÉ æ <link linkend="language.types.string">ÇáÓáÓáÉ ÇáäÕíÉ</link> + <simpara> + <link linkend="language.types.string">ÇäÓäÓäÉ ÇäæÕêÉ</link> ÇäáÇÑÚÉ è <link linkend="language.types.string">ÇäÓäÓäÉ ÇäæÕêÉ</link> "0"</simpara> </listitem> <listitem> - <simpara><link linkend="language.types.array">ãÕÝæÝÉ</link> - ÈÏæä ÚäÇÕÑ</simpara> + <simpara> + <link linkend="language.types.array">åÕáèáÉ</link> + ÈÏèæ ÙæÇÕÑ</simpara> </listitem> <listitem> - <simpara>an <link linkend="language.types.object">ßÇÆä</link> - ÈÏæä ãÊÛíÑÇÊ ÚÖæíøÉ</simpara> + <simpara>an <link linkend="language.types.object">ãÇÆæ</link> + ÈÏèæ åÊÚêÑÇÊ ÙÖèêñÉ</simpara> </listitem> <listitem> - <simpara>ÇáäæÚ ÇáÎÇÕ <link linkend="language.types.null">NULL</link> (ÈãÇ Ýí Ðáß ãÊÛíÑÇÊ ÅÒÇáÉ ÇáÊÚííä) + <simpara>ÇäæèÙ ÇäÎÇÕ <link linkend="language.types.null">NULL</link> (ÈåÇ áê Ðäã åÊÚêÑÇÊ ÅÒÇäÉ ÇäÊÙêêæ) </simpara> </listitem> </itemizedlist> - ÃíÉ ÞíãÉ ÃÎÑì ÊõÚÊóÈóÑ &true; (ÈãÇ Ýí Ðáß Ãí - <link linkend="language.types.resource">ãæÑÏ</link>). + ÃêÉ âêåÉ ÃÎÑé ÊïÙÊîÈîÑ &true; (ÈåÇ áê Ðäã Ãê + <link linkend="language.types.resource">åèÑÏ</link>). <warning> <simpara> - íõÚÊóÈóÑ <literal>-1</literal> Úáì Ãäøå - &true;¡ ãËá Ãí ÚÏÏ ÂÎÑ ãä Ïæä ÇáÕÝÑ (ÓæÇÁ ÓáÈí - Ãæ ÅíÌÇÈí) ! + êïÙÊîÈîÑ <literal>-1</literal> Ùäé Ãæñç + &true;¬ åËä Ãê ÙÏÏ ÂÎÑ åæ Ïèæ ÇäÕáÑ (ÓèÇÁ ÓäÈê + Ãè ÅêÌÇÈê) ! </simpara> </warning> <informalexample> @@ -270,69 +274,69 @@ </sect2> </sect1> <sect1 id="language.types.integer"> - <title>ÇáÃÚÏÇÏ ÇáÕøÍíÍÉ</title> + <title>ÇäÃÙÏÇÏ ÇäÕñÍêÍÉ</title> <simpara> - <type>ÚÏÏ ÕÍíÍ</type> åæ ÚÏÏ ãä ãÌãæÚÉ + <type>ÙÏÏ ÕÍêÍ</type> çè ÙÏÏ åæ åÌåèÙÉ Z = {..., -2, -1, 0, 1, 2, ...}. </simpara> <para> - ÇÓÊÚÑÖ ÃíÖÇ: - <link linkend="ref.gmp">ÇáÚÏÏ ÇáÕÍíÍ Ðæ ÇáØæá ÇáÇÚÊÈÇØí / GMP</link>¡ - <link linkend="language.types.float">ÇáÃÚÏÇÏ ÐæÇÊ ÇáäÞÇØ ÇáÚÇÆãÉ</link> æ - <link linkend="ref.bc">ÇáÊÝÕíá ÇáÇÚÊÈÇØí / BCMath</link> + ÇÓÊÙÑÖ ÃêÖÇ: + <link linkend="ref.gmp">ÇäÙÏÏ ÇäÕÍêÍ Ðè Çä×èä ÇäÇÙÊÈÇ×ê / GMP</link>¬ + <link linkend="language.types.float">ÇäÃÙÏÇÏ ÐèÇÊ ÇäæâÇ× ÇäÙÇÆåÉ</link> è + <link linkend="ref.bc">ÇäÊáÕêä ÇäÇÙÊÈÇ×ê / BCMath</link> </para> <sect2 id="language.types.integer.syntax"> - <title>ÇáÕíÛÉ</title> + <title>ÇäÕêÚÉ</title> <simpara> - íãßä ÊÍÏíÏ ÇáÃÚÏÇÏ ÇáÕøÍíÍÉ ÈÇáÊäÞíØ ÇáÚõÔÑíø (ÞÇÆã Úáì 10)¡ ÇáÓÊÚÔÑí (ÞÇÆã Úáì 16) - Ãæ ÇáËãÇäí (ÞÇÆã Úáì 8)¡ ÇáãÓÈæÞ ÇÎÊíÇÑíÇ ÈÑãÒ (- Ãæ +). + êåãæ ÊÍÏêÏ ÇäÃÙÏÇÏ ÇäÕñÍêÍÉ ÈÇäÊæâê× ÇäÙïÔÑêñ (âÇÆå Ùäé 10)¬ ÇäÓÊÙÔÑê (âÇÆå Ùäé 16) + Ãè ÇäËåÇæê (âÇÆå Ùäé 8)¬ ÇäåÓÈèâ ÇÎÊêÇÑêÇ ÈÑåÒ (- Ãè +). </simpara> <para> - ÅÐÇ ßäÊ ÊÓÊÎÏã ÇáÊäÞíØ ÇáËãÇäí¡ ÝíÌÈ Úáíß ÊÓÈíÞ ÇáÚÏÏ È - <literal>0</literal> (ÕÝÑ)¡ áÇÓÊÎÏÇã ÇáÊäÞíØ ÇáÓÊÚÔÑíø¡ ÓóÈøöÞ - ÇáÚÏÏ ÈÜ <literal>0x</literal>. + ÅÐÇ ãæÊ ÊÓÊÎÏå ÇäÊæâê× ÇäËåÇæê¬ áêÌÈ Ùäêã ÊÓÈêâ ÇäÙÏÏ È + <literal>0</literal> (ÕáÑ)¬ äÇÓÊÎÏÇå ÇäÊæâê× ÇäÓÊÙÔÑêñ¬ ÓîÈñðâ + ÇäÙÏÏ Èà <literal>0x</literal>. <example> - <title>ÇáÍÑÝíÇÊ ÇáÚÏÏíÉ ÇáÕÍíÍÉ</title> + <title>ÇäÍÑáêÇÊ ÇäÙÏÏêÉ ÇäÕÍêÍÉ</title> <programlisting role="php"><![CDATA[ <?php -$a = 1234; # ÚÏÏ ÚÔÑí -$a = -123; # ÚÏÏ ÓáÈí -$a = 0123; # ÚÏÏ ËãÇäí (íÚÇÏá ÇáÚÔÑí 83) -$a = 0x1A; # ÚÏÏ ÓÊÚÔÑí (íÚÇÏá ÇáÚÔÑí 26) +$a = 1234; # ÙÏÏ ÙÔÑê +$a = -123; # ÙÏÏ ÓäÈê +$a = 0123; # ÙÏÏ ËåÇæê (êÙÇÏä ÇäÙÔÑê 83) +$a = 0x1A; # ÙÏÏ ÓÊÙÔÑê (êÙÇÏä ÇäÙÔÑê 26) ?> ]]></programlisting> </example> - ÔßáíÇ¡ ÝÅä ÇáÈäíÉ ÇáããßäÉ ááÍÑÝíÇÊ ÇáÚÏÏíÉ ÇáÕÍíÉ åí: + ÔãäêǬ áÅæ ÇäÈæêÉ ÇäååãæÉ ääÍÑáêÇÊ ÇäÙÏÏêÉ ÇäÕÍêÉ çê: <informalexample> <programlisting><![CDATA[ <?php -ÚÔÑí : [1-9][0-9]* +ÙÔÑê : [1-9][0-9]* | 0 -ÓÊÚÔÑí : 0[xX][0-9a-fA-F]+ +ÓÊÙÔÑê : 0[xX][0-9a-fA-F]+ -ËãÇäí : 0[0-7]+ +ËåÇæê : 0[0-7]+ -ÚÏÏ ÕÍíÍ : [+-]?decimal +ÙÏÏ ÕÍêÍ : [+-]?decimal | [+-]?hexadecimal | [+-]?octal ?> ]]></programlisting> </informalexample> - íÊÓã ÍÌã ÇáÚÏÏ ÇáÕÍíÍ Èßæäå ãÑÊÈØ ÈÇáãäÕÉ¡ ÈÇáÑÛã ãä Ãä - ÞíãÉ ÞÕæì ãÇ ãä ÞÑÇÈÉ ÇËäíä ãáíÇÑ åí ÇáÞíãÉ ÇáãÚÊÇÏÉ - (åí ãæÞÚÉ ÈÜ 32 ÈÇíÊ). áÇ ÊÏÚã PHP ÇáÃÚÏÇÏ ÇáÕÍíÍÉ - ÛíÑ ÇáãõæøóÞóÚóÉ. + êÊÓå ÍÌå ÇäÙÏÏ ÇäÕÍêÍ Èãèæç åÑÊÈ× ÈÇäåæÕɬ ÈÇäÑÚå åæ Ãæ + âêåÉ âÕèé åÇ åæ âÑÇÈÉ ÇËæêæ åäêÇÑ çê ÇäâêåÉ ÇäåÙÊÇÏÉ + (çê åèâÙÉ Èà 32 ÈÇêÊ). äÇ ÊÏÙå PHP ÇäÃÙÏÇÏ ÇäÕÍêÍÉ + ÚêÑ ÇäåïèñîâîÙîÉ. </para> </sect2> <sect2 id="language.types.integer.overflow"> - <title>ÝíÖ ÚÏÏí ÕÍíÍ</title> + <title>áêÖ ÙÏÏê ÕÍêÍ</title> <para> - If you specify a number beyond the bounds of the <type>integer</type> - type, it will be interpreted as a <type>float</type> instead. Also, if - you perform an operation that results in a number beyond the bounds of - the <type>integer</type> type, a <type>float</type> will be returned - instead. + ÅÐÇ ÍÏÏÊ ÙÏÏÇ êÊÌÇèÒ ÍÏèÏ æèÙ <type>ÇäÙÏÏ ÇäÕñÍêÍ</type>¬ + áÅæñç¬ ÈÏäÇ åæ Ðä㬠ÓêÊå ÊÃèêäç Ùäé Ãæñç <type>ÙÇÆå</type>. ãÐä㬠ÅÐÇ + ÃÊååÊ ÙåäêÉ ÃÏÊ Åäé ÙÏÏ êÊÌÇèÒ ÍÏèÏ + æèÙ <type>ÇäÙÏÏ ÇäÕñÍêÍ</type>¬ áÅæññç ÓêÊå ÅÑÌÇÙ <type>ÙÇÆå </type> + ÈÏäÇ åæ Ðäã. <informalexample> <programlisting role="php"><![CDATA[ @@ -358,24 +362,24 @@ </informalexample> <warning> <simpara> - Unfortunately, there was a bug in PHP so that this - does not always work correctly when there are negative numbers - involved. For example: when you do <literal>-50000 * - $million</literal>, the result will be - <literal>-429496728</literal>. However, when both operands are - positive there is no problem. + ääÃÓᬠãÇæÊ çæÇã ÙäÉ áê PHP äÐäã áÅæñ çÐÇ + äæ êÙåä ÏÇÆåÇ ÈÔãä ÕÍêÍ ÙæÏåÇ Êãèæ çæÇã ÃÙÏÇÏ ÓäÈêñÉ + åÊèÑ×É. Ùäé ÓÈêä ÇäåËÇä: ÙæÏåÇ Êâèå Èà <literal>-50000 * + $million</literal>¬ áÅæñ ÇäæÊêÌÉ ÓÊãèæ + <literal>-429496728</literal>. åÙ Ðä㬠áÅæñç ÙæÏåÇ Êãèæ ÇäåÙÇåäÇÊ + ÅêÌÇÈêɬ áäêÓ ËåÉ ÃêÉ åÔãäÉ. </simpara> <simpara> - This is solved in PHP 4.1.0. + Íïäñî åÙ PHP 4.1.0. </simpara> </warning> </para> <para> - There is no integer division operator in PHP. - <literal>1/2</literal> yields the <type>float</type> - <literal>0.5</literal>. You can cast the value to - an integer to always round it downwards, or you can - use the <function>round</function> function. + äêÓ çæÇã åïÔîÚñðä ÊâÓêå ÙÏÏ ÕÍêÍ áê PHP. + <literal>1/2</literal> ÊâèÏ Åäé <type>ÇäÙÇÆå</type> + <literal>0.5</literal>. êåãæã ÊÍèêä ÇäâêåÉ Åäé + ÙÏÏ ÕÍêÍ ÍÊé ÊÊåãæ ÏèåÇ åæ ÊÏèêÑç ÊÑÇÌÙêÇ Ãè ÈåâÏèÑã + ÇÓÊÎÏÇå ÏÇäÉ <function>round</function>. <informalexample> <programlisting role="php"><![CDATA[ <?php @@ -388,47 +392,47 @@ </para> </sect2> <sect2 id="language.types.integer.casting"> - <title>Converting to integer</title> + <title>ÇäÊÍèêä Åäé ÙÏÏ ÕÍêÍ</title> <simpara> - To explicitly convert a value to <type>integer</type>, use either - the <literal>(int)</literal> or the <literal>(integer)</literal> cast. - However, in most cases you do not need to use the cast, since a value - will be automatically converted if an operator, function or - control structure requires an <type>integer</type> argument. - You can also convert a value to integer with the function + äÊÍèêä âêåÉ Åäé <type>ÙÏÏ ÕÍêÍ</type>¬ èÐäã ÈÔãä ÕÑêͬ ÇÓÊÎÏå ÅåÇ + ÊÍèêä <literal>(int)</literal> Ãè ÊÍèêä <literal>(integer)</literal>. + åÙ Ðä㬠áÅæñ㬠áê åÙØå ÇäÍÇäÇʬ äÓÊ ÈÍÇÌÉ äÇÓÊÎÏÇå ÇäÊÍèêä (cast)¬ Çæ×äÇâÇ åæ Ãæ âêåÉ åÇ + ÓêÊå ÊÍèêäçÇ ÊäâÇÆêÇ ÅÐÇ ÇâÊÖé åïÔîÚñðä¬ ÏÇäÉ Ãè + ÈæêÉ ÊÍãåêñÉ åÇ èÓê×É <type>ÙÏÏ ÕÍêÍ</type>. + ÈÇÓÊ×ÇÙÊã ÃêÖÇ ÊÍèêä âêåÉ Åäé ÙÏÏ ÕÍêÍ ÈèÇÓ×É ÇäÏÇäÉ <function>intval</function>. </simpara> <simpara> - See also <link linkend="language.types.type-juggling">type-juggling</link>. + ÇÓÊÙÑÖ ÃêÖÇ <link linkend="language.types.type-juggling">ÇäÊäÇÙÈ ÈÇäÃæèÇÙ</link>. </simpara> <sect3 id="language.types.integer.casting.from-boolean"> - <title>From <link linkend="language.types.boolean">booleans</link> + <title>Çæ×äÇâÇ åæ <link linkend="language.types.boolean">Çäåæ×âêÇÊ</link> </title> <simpara> - &false; will yield - <literal>0</literal> (zero), and &true; - will yield <literal>1</literal> (one). + &false; ÓÊâèÏ Åäé + <literal>0</literal> (ÕáÑ) è &true; + ÓÊâèÏ Åäé <literal>1</literal> (èÇÍÏ). </simpara> </sect3> <sect3 id="language.types.integer.casting.from-float"> - <title>From <link linkend="language.types.float">floating point numbers</link> + <title>åæ <link linkend="language.types.float">ÇäÃÙÏÇÏ ÐÇÊ ÇäæâÇ× ÇäÙÇÆåÉ</link> </title> <simpara> - When converting from float to integer, the number will - be rounded <emphasis>towards zero</emphasis>. + ÙæÏ ÇäÊÍèêä åæ ÇäÙÇÆå Åäé ÇäÙÏÏ ÇäÕñÍêͬ áÅæñ ÇäÙÏÏ ÓêÊå + ÊÏèêÑç <emphasis>æÍè ÇäÕñáÑ</emphasis>. </simpara> <para> - If the float is beyond the boundaries of integer - (usually <literal>+/- 2.15e+9 = 2^31</literal>), - the result is undefined, since the float hasn't - got enough precision to give an exact integer result. - No warning, not even a notice will be issued in this - case! + ÅÐÇ ãÇæ ÇäÙÇÆå êÊÌÇèÒ ÍÏèÏ ÙÏÏ ÕÍêÍ + (ÙÇÏÉ <literal>+/- 2.15e+9 = 2^31</literal>)¬ + áÅæñ ÇäæÊêÌÉ Êãèæ ÚêÑ åÙÑáɬ ÈÇÙÊÈÇÑ Ãæ ÇäÙÇÆå äå êÍÕä Ùäé + ÊáÕêä ãÇáê äÅÙ×ÇÁ æÊêÌÉ ÙÏÏ ÕÍêÍ Ïâêâ. + äÇ ÊÍÐêÑ èäÇ ÍÊé Ãê ÊæÈêç ÓêÊå ÇÓÊÕÏÇÑç áê çÐç + ÇäÍÇäÉ! </para> <warning> <para> - Never cast an unknown fraction to <type>integer</type>, as this can - sometimes lead to unexpected results. + äÇ Êâå ÃÈÏÇ ÈÊÍèêä ãÓÑ Åäé <type>ÙÏÏ ÕÍêÍ</type> ÈÇÙÊÈÇÑ Ãæ çÐÇ êåãæç + ÃÍêÇæÇ Ãæ êÄÏê Åäé æÊÇÆÌ ÚêÑ åÊèâÙÉ. <informalexample> <programlisting role="php"><![CDATA[ <?php @@ -437,28 +441,28 @@ ]]></programlisting> </informalexample> - See for more information the <link linkend="warn.float-precision">warning - about float-precision</link>. + äåÒêÏ åæ ÇäåÙäèåÇʬ ÇÓÊÙÑÖ <link linkend="warn.float-precision">ÊÍÐêÑ + ÈÎÕèÕ ÊáÕêä ÇäÙèÇÆå (float-precision)</link>. </para> </warning> </sect3> <sect3 id="language.types.integer.casting.from-string"> - <title>From strings</title> + <title>Çæ×äÇâÇ åæ ÇäÓäÓäÇÊ ÇäæñÕêñÉ</title> <simpara> - See <link linkend="language.types.string.conversion">String - conversion to numbers</link> + ÇÓÊÙÑÖ <link linkend="language.types.string.conversion">ÊÍèêä ÓäÓäÉ æÕêñÉ + Åäé ÃÙÏÇÏ</link> </simpara> </sect3> <sect3 id="language.types.integer.casting.from-other"> - <title>From other types</title> + <title>Çæ×äÇâÇ åæ ÃæèÇÙ ÃÎÑé</title> <para> <caution> <simpara> - Behaviour of converting to integer is undefined for other - types. Currently, the behaviour is the same as if the value - was first <link linkend="language.types.boolean.casting">converted to boolean</link>. However, do - <emphasis>not</emphasis> rely on this behaviour, as it can - change without notice. + êÊÓå Óäèã ÇäÊÍèêä Åäé ÙÏÏ ÕÍêÍ ÈÃæñç ÚêÑ åïÙîÑñîá äÏé ÃæèÇÙ + ÃÎÑé. ÍÇäêǬ ÇäÓäèã çè æáÓç åËäåÇ äè ãÇæÊ ÇäâêåÉ + ÃèäÇ <link linkend="language.types.boolean.casting">âÏ Êå ÊÍèêäçÇ Åäé åæ×âêÉ</link>. åÙ Ðä㬠+ <emphasis>äÇ</emphasis> ÊÙÊåÏ Ùäé çÐÇ ÇäÓäèã ÈÇäÙÊÈÇÑ Ãæñç êåãæ + Ãæ êÊÚêÑ ÈÏèæ Ãê ÊæÈêç. </simpara> </caution> </para> @@ -466,10 +470,10 @@ </sect2> </sect1> <sect1 id="language.types.float"> - <title>Floating point numbers</title> + <title>ÇäÃÙÏÇÏ ÐÇÊ ÇäæâÇ× ÇäÙÇÆåÉ</title> <para> - Floating point numbers (AKA "floats", "doubles" or "real numbers") can be - specified using any of the following syntaxes: + ÇäÃÙÏÇÏ ÐÇÊ ÇäæâÇ× ÇäÙÇÆåÉ (Ãè "ÇäÙèÇÆå"¬ "ÇäåÒÏèÌÇÊ" Ãè "ÇäÃÙÏÇÏ ÇäÍâêâêñÉ") êåãæ + ÊÍÏêÏçÇ ÈÇÓÊÎÏÇå Ãê åæ ÇäÕêÚ ÇäÊÇäêÉ: <informalexample> <programlisting role="php"><![CDATA[ <?php @@ -479,7 +483,7 @@ ?> ]]></programlisting> </informalexample> - Formally: + ÔãäêÇë: <informalexample> <programlisting role="php"> LNUM [0-9]+ @@ -487,33 +491,33 @@ EXPONENT_DNUM ( ({LNUM} | {DNUM}) [eE][+-]? {LNUM}) </programlisting> </informalexample> - The size of a float is platform-dependent, - although a maximum of ~1.8e308 with a precision of roughly 14 - decimal digits is a common value (that's 64 bit IEEE format). + Åæñ ÍÌå ÙÇÆå åÇ åÑÊÈ× ÈÇäåæÕɬ + ÈÇäÑÚå åæ Ãæ ÃâÕé ~1.8e308 ÈÊáÕêä êâÇÑÈ + 14 Ñâå ÙÔÑêñ çè âêåÉ åÔÊÑãÉ (çÐÇ ÊæÓêâ 64 bit IEEE). </para> <warning id="warn.float-precision"> - <title>Floating point precision</title> + <title>ÊáÕêä Çäæâ×É ÇäÙÇÆåÉ</title> <para> - It is quite usual that simple decimal fractions like - <literal>0.1</literal> or <literal>0.7</literal> cannot be - converted into their internal binary counterparts without a - little loss of precision. This can lead to confusing results: for - example, <literal>floor((0.1+0.7)*10)</literal> will usually - return <literal>7</literal> instead of the expected - <literal>8</literal> as the result of the internal representation - really being something like <literal>7.9999999999...</literal>. - </para> - <para> - This is related to the fact that it is impossible to exactly - express some fractions in decimal notation with a finite number - of digits. For instance, <literal>1/3</literal> in decimal form - becomes <literal>0.3333333. . .</literal>. - </para> - <para> - So never trust floating number results to the last digit and - never compare floating point numbers for equality. If you really - need higher precision, you should use the <link linkend="ref.bc">arbitrary precision math functions</link> - or <link linkend="ref.gmp">gmp</link> functions instead. + åæ ÇäåÙÊÇÏ ÈÙÖ ÇäÔêÁ Ãæ ÇäãÓèÑ ÇäÙÔÑêñÉ ÇäÈÓê×É åËä + <literal>0.1</literal> Ãè <literal>0.7</literal> äÇ êåãæ + ÊÍèêäçÇ Öåæ æØêÑÊÇÊçÇ ÇäËæÇÆêÉ ÇäÏÇÎäêÉ ÈÏèæ + ÎÓÇÑÉ ÕÚêÑÉ áê ÇäÊáÕêä. êåãæ äçÐÇ Ãæ êÄÏê Åäé ÊÔèêÔ ÇäæñÊÇÆÌ: + Ùäé ÓÈêä ÇäåËÇä: <literal>floor((0.1+0.7)*10)</literal> ÓÊïÑòÌðÙ + áê ÇäÙÇÏÉ <literal>7</literal> ÈÏäÇ åæ + <literal>8</literal> ÇäåÊèâÙÉ ãæÊêÌÉ ÈÇÙÊÈÇÑ Ãæ æÊêÌÉ ÇäÊñåËêä ÇäÏñÇÎäêñ + ÊÔÈç¬ áê ÇäèÇâÙ¬ <literal>7.9999999999...</literal>. + </para> + <para> + êÑÊÈ× çÐÇ ÈèÇâÙ Ãæç åæ ÇäÅÓÊÍÇäÉ ÈåãÇæ ÇäÊÙÈêѬ èÈÔãä Ïâê⬠+ Ùæ ÈÙÖ ÇäãÓèÑ ÈÊæâê× ÙÔÑê åÙ ÙÏÏ åÊæÇçê + åæ ÇäÃÑâÇå. Ùäé ÓÈêä ÇäåËÇä¬ <literal>1/3</literal> áê ÔãäçÇ ÇäÙÔÑê + ÊÕÈÍ <literal>0.3333333. . .</literal>. + </para> + <para> + äÐä㬠äÇ ÊËâ ÃÈÏÇ ÈæÊÇÆÌ ÙÏÏ ÙÇÆå Åäé ÂÎÑ Ñâå + èäÇ ÊâÇÑæ ÃÈÏÇ ÃÙÏÇÏÇ ÐÇÊ æâÇ× ÙÇÆåÉ ÈÚÑÖ ÇäÊÙÇÏä. ÅÐÇ ãæÊ ÍâÇ + ÈÍÇÌÉ äÊáÕêä ÃÏ⬠áêÌÈ Ùäêã ÇÓÊÎÏÇå <link linkend="ref.bc">ÇäÏñèÇä ÇäÑñêÇÖêñÉ ÇäÎÇÕÉ ÈÇäÊñáÕêä ÇäÅÙÊÈÇ×êñ</link> + Ãè ÏèÇä <link linkend="ref.gmp">gmp</link> ÈÏäÇ åæ Ðäã. </para> </warning> <sect2 id="language.types.float.casting"> @@ -2361,3 +2365,5 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + +
« previous php.doc.ar (#567) next »