cvs: phpdoc-ar /language references.xml

From: Date: Thu, 14 Aug 2003 23:08:39 +0000
Subject: cvs: phpdoc-ar /language references.xml
Groups: php.doc.ar 
Request: Send a blank email to doc-ar+get-531@lists.php.net to get a copy of this message
hafid Thu Aug 14 19:08:39 2003 EDT Added files: /phpdoc-ar/language references.xml Log: Translated by Mostafa Foda. Revised by Hafid. En 1.25 compliant

Index: phpdoc-ar/language/references.xml +++ phpdoc-ar/language/references.xml <?xml version="1.0" encoding="ISO-8859-6"?> <!-- $Revision: 1.1 $ --> <!-- Updated to En 1.25 --> <chapter id="language.references"> <title>ÔÑÍ ÇäåÑÇÌÙ</title> <sect1 id="language.references.whatare"> <title>åÇçêÉ ÇäåÑÇÌÙ</title> <simpara> ÇäåÑÇÌÙ áê PHP çé èÓÇÆä äèäèÌ åÍÊèé æáÓ ÇäåÊÚêÑ åæ ÎäÇä ÃÓåÇÁ åÎÊäáÉ. çê äÇ ÊÔÈç åÄÔÑÇÊ C¬ çê ÙÈÇÑÉ Ùæ ÃÓåÇÁ åÓÊÙÇÑÉ äÌÏèä ÇäÑåèÒ. äÇÍØ Ãæç áê PHP¬ ÅÓå ÇäåÊÚêÑ êÎÊäá Ùæ åÍÊèé ÇäåÊÚêÑ ÈÍêË Ãæñ æáÓ ÇäåÍÊèé êåãæ Ãæ êÃÎÐ ÃÓåÇÁë åÎÊäáÉ. ÃâÑÈ ÊåÇËä êÍÏË åÙ ÃÓåÇÁ åäáÇÊ Unix èÊïÙÊÈÑ ÃÓåÇÁ åÊÚêÑÇÊ ÇäåäáÇÊ çê åïÏÎäÇÊ ÇäåÌäÏÇÊ áê Íêæ Ãæñ åÍÊèêÇÊ ÇäåÊÚêÑÇÊ çê Çäåäá ÈÍÏ ÐÇÊç. êåãæ ÇäæØÑ Åäé ÇäåÑÇÌÙ Ùäé ÃæñçÇ ×ÑêâÉ ÕÙÈÉ äÅÍÏÇË ÑèÇÈ× áê æØÇå åäáÇÊ Unix. </simpara> </sect1> <sect1 id="language.references.whatdo"> <title>åÇÐÇ ÊáÙä ÇäåÑÇÌÙ¿</title> <para> åÑÇÌÙ PHP ÊÓåÍ äã Ãæ ÊÌÙä åÊÚêÑêæ êÔêÑÇæ Åäé æáÓ ÇäåÍÊèé. Ùäé ÓÈêä ÇäåËÇä¬ ÙæÏåÇ Êâèå Èà : <informalexample> <programlisting role="php"><![CDATA[ <?php $a =& $b ?> ]]></programlisting> </informalexample> êÙæê çÐÇ Ãæñ <varname>$a</varname> è <varname>$b</varname> êÔêÑÇæ Åäé æáÓ ÇäåÊÚêÑ. <note> <para> êÊÓå <varname>$a</varname> è <varname>$b</varname> ÈÊåÇå ÊÓÇèêçåÇ çæÇ¬ äêÓ Ãæñ <varname>$a</varname> êÔêÑ Åäé <varname>$b</varname> Ãè ÇäÙãÓ ÈÇäÙãÓ¬ ÇäÃåÑ çæÇ êÊÙäâ ÈÃæñ <varname>$a</varname> è <varname>$b</varname> êÔêÑÇ Åäé æáÓ ÇäåãÇæ. </para> </note> </para> <para> êåãæ ÇÓÊÎÏÇå æáÓ ÇäÕêÚÉ åÙ ÇäÏñèÇä ÇäÊñê ÊïÑÌÙ åÑÇÌÙ èãÐÇ åÙ ÇäåÙÇåä <literal>new</literal> (áê PHP 4.0.4 èÃÍÏË): <informalexample> <programlisting role="php"><![CDATA[ <?php $bar =& new fooclass(); $foo =& find_var ($bar); ?> ]]></programlisting> </informalexample> </para> <note> <para> êÊÓÈÈ ÙÏå ÇÓÊÎÏÇå ÇäåÙÇåä <literal>&amp;</literal> áê Ùåä æÓÎÉ åæ ÇäãÇÆæ. ÇÐÇ ãæÊ ÊÓÊÎÏå <literal>$this</literal> áê ÇäÕñðæá¬ áÅæñçÇ Óèá ÊÙåä Ùäé ÇäÙêñæÉ ÇäÍÇäêñÉ åæ ÇäÕñðæá. ÇäÊÙêêæ ÈÏèæ <literal>&amp;</literal> ÓêÄÏê Åäé æÓÎ ÇäÙêñæÉ (åËäÇ: ÇäãÇÆæ) èÓÊÙåä <literal>$this</literal> Ùäé ÇäæÓÎÉ ÇäÔêÁ ÇäÐê äÇ êÙÊÈÑ ÏèåÇ ÇäåÑÚèÈ áêç. ÙÇÏÉï¬ ÃæÊ ÊÑêÏ ÇäÍÕèä Ùäé ÙêñæÉ èÇÍÏÉ ÊÙåä æØÑÇ äåÓÇÆä ÇäÃÏÇÁ èÇÓÊçäÇã ÇäÐÇãÑÉ. </para> <para> áê Íêæ êåãæã ÇÓÊÎÏÇå ÇäåÙÇåä <literal>@</literal> ÈÚÑÖ <emphasis>ÅÓãÇÊ</emphasis> ÃêÉ ÃÎ×ÇÁ áé ÇäÈÇæê ÙæÏ ÇÓÊÎÏÇåçÇ Ùäé Ôãä <literal>@new</literal>¬ äÇ êÙåä ÙæÏ ÇÓÊÎÏÇå ÈäÇÚ <literal>&amp;new</literal>. êïÙÏñï çÐÇ ÊÍÏêÏÇ áê åÍÑã Zend èêÄÏê ÈÇäÊÇäê Åäé Î×à áê ÇäåáÓÑ. </para> </note> <para> ÇäÃåÑ ÇäËÇæê ÇäÐê Êâèå Èç ÇäåÑÇÌÙ çè ÊåÑêÑ ÇäåÊÚêÑÇÊ åÑÌÙêÇë. . êÊå çÐÇ åæ ÎäÇä ÅÍÏÇË åÊÚêÑ åÍäê áé ÏÇäÉ èãÐÇ åÊÚêÑ áê åÑÌÙ åÏé ÇäåæÇÏÇÉ êÔêÑ Åäé æáÓ ÇäåÍÊèé. åËäÇ: <informalexample> <programlisting role="php"><![CDATA[ <?php function foo (&$var) { $var++; } $a=5; foo ($a); ?> ]]></programlisting> </informalexample> ÓêÌÙä <varname>$a</varname> ÊÓÇèê 6. êÍÏË çÐÇ äÃæñç áé ÇäÏÇäÉ <varname>foo</varname>¬ ÇäåÊÚêñðÑ <varname>$var</varname> êÔêÑ Åäé æáÓ ÇäåÍÊèé åËä <varname>$a</varname>. ÇÓÊÙÑÖ åÒêÏÇ åæ ÇäÔÑèÍÇÊ ÇäÃãËÑ ÊáÕêäÇ ÈÎÕèÕ <link linkend="language.references.pass">ÇäÊåÑêÑ ÙÈÑ ÇäåÑÇÌÙ</link>. </para> <simpara> ÇäÃåÑ ÇäËÇäË ÇäÐé êÓÊ×êÙ ÇäåÑÌÙ ÇäâêÇå Èç çè <link linkend="language.references.return">ÇäÅÑÌÇÙ ÙÈÑ ÇäåÑÇÌÙ</link>. </simpara> </sect1> <sect1 id="language.references.arent"> <title>åÇ äÇ êÏÎä Öåæ åÇçêÉ ÇäåÑÇÌÙ</title> <para> ãåÇ âêä åæ âÈä¬ áÅæ ÇäåÑÇÌÙ äêÓÊ åÄÔÑÇÊ. êÙæê çÐÇ Ãæñ ÇäÈæÇÁ ÇäÊÇäê äæ êâèå ÈåÇ ÊÊèâÙç: <informalexample> <programlisting role="php"><![CDATA[ <?php function foo (&$var) { $var =& $GLOBALS["baz"]; } foo($bar); ?> ]]></programlisting> </informalexample> </para> <simpara> åÇ êÍÏË çè Ãæñ <varname>$var</varname> áê <varname>foo</varname> ÓêïÑÈî× Èà <varname>$bar</varname> áé ÇäåïæÇÏê äãæñç ÍêæçÇ ÓêïÙÇÏï ÑÈ×ç Èà <varname>$GLOBALS["baz"]</varname>. äêÓÊ çæÇã åæ ×ÑêâÉ äÑÈ× <varname>$bar</varname>¬ áê åÏé ÇäåæÇÏÇɬ ÈÔêÁ ÂÎÑ ÈÅÓÊÎÏÇå ÂäêÉ åÑÌÙêñÉ ÍêË Ãæ<varname>$bar</varname> äêÓ åÊÇÍÇë áé ÇäÏÇäÉ <varname>foo</varname> (êÊå ÊåËêäç Èà <varname>$var</varname> äãæ <varname>$var</varname> êÊèáÑ áâ× Ùäé åÍÊèêÇÊ åÊÚêÑÇÊ èäêÓ Ùäé åêÒÉ ÑÈ× ÇäÇÓå ÈÇäâêåÉ áé ÌÏèä ÑåÒ ÇäåæÇÏÇÉ). </simpara> </sect1> <sect1 id="language.references.pass"> <title>ÇäÊåÑêÑ ÙÈÑ ÇäåÑÇÌÙ</title> <para> ÈÅÓÊ×ÇÙÊã Ãæ ÊïåÑÑ åÊÚêÑÇ Åäé ÏÇäÉ ÙÈÑ ÇäåÑÇÌÙ ÈÍêË êãèæ êÅåãÇæ çÐç ÇäÏÇäÉ ÊÙÏêä åÄÔÑÇÊçÇ. ÇäÕêÚÉ çê ãåÇ êäê: <informalexample> <programlisting role="php"><![CDATA[ <?php function foo (&$var) { $var++; } $a=5; foo ($a); // $a ÊÓÇèê 6 çæÇ ?> ]]></programlisting> </informalexample> äÇÍØ Ãæç äÇ ÊèÌÏ ÙäÇåÉ ÇäåÑÌÙêÉ áé ÇÓÊÏÙÇÁ ÇäÏÇäÉ - áçê åèÌèÏÉ áâ× áê ÊÙÑêá ÇäÏÇäÉ. ÊÙÑêá ÇäÏÇäÉ èÍÏç êãáé äÊåÑêÑ ÇäåÄÔÑ ÙÈÑ ÇäåÑÇÌÙ èÈÔãä ÕÍêÍ. </para> <para> ÇäÃÔêÇÁ ÇäÂÊêñÉ êåãæ ÊåÑêÑçÇ åÑÌÙêÇë: <itemizedlist> <listitem> <simpara> åÊÚêѬ åËäÇ <literal>foo($a)</literal> </simpara> </listitem> <listitem> <simpara> ÈäÇÚ New¬ åËäÇ <literal>foo(new foobar())</literal> </simpara> </listitem> <listitem> <para> åÑÌÙ ÙÇÆÏ åæ ÏÇäɬ åËäÇ: <informalexample> <programlisting role="php"><![CDATA[ <?php function &bar() { $a = 5; return $a; } foo(bar()); ?> ]]></programlisting> </informalexample> ÇÓÊÙÑÖ ÃêÖÇ ÇäÔÑèÍÇÊ ÈÎÕèÕ <link linkend="language.references.return">ÇäÅÑÌÇÙ ÙÈÑ ÇäåÑÇÌÙ</link>. </para> </listitem> </itemizedlist> </para> <para> ÃêÉ ÙÈÇÑÉ ÃÎÑé êæÈÚé ÃäÇ ÊïåîÑñîÑ åÑÌÙêÇë¬ ÈÇÙÊÈÇÑ Ãæñ ÇäæÊêÌÉ ÚêÑ åïÙîÑñîáîÉ. áåËäÇë æÌÏ Ãæ ÇäÃåËäÉ ÇäÊÇäêÉ ÇäÎÇÕÉ ÈÇäÊåÑêÑ ÙÈÑ ÇäåÑÇÌÙ çê ÚêÑ ÕÇäÍÉ: <informalexample> <programlisting role="php"><![CDATA[ <?php function bar() // äÇÍØ & ÇäæÇâÕÉ { $a = 5; return $a; } foo(bar()); foo($a = 5) // ÙÈÇÑÉ èäêÓ åÊÚêÑ foo(5) // ËÇÈÊ èäêÓ åÊÚêÑ ?> ]]></programlisting> </informalexample> çÐç ÇäåÊ×äÈÇÊ ÊÎÕ PHP 4.0.4 èÈÙÏçÇ. </para> </sect1> <sect1 id="language.references.return"> <title>ÅÑÌÇÙ ÇäåÑÇÌÙ</title> <para> êÊÓå ÇäÅÑÌÇÙ ÙÈÑ ÇäåÑÇÌÙ Èãèæç åáêÏÇ ÙæÏåÇ ÊÑêÏ ÇÓÊÎÏÇå ÏÇäÉ äÊÍÏêÏ Ãê åÊÚêÑ êæÈÚê ÑÈ× ÇäåÑÌÙ Èç. ÙæÏ ÅÑÌÇÙ åÑÇÌÙ¬ ÇÓÊÎÏå çÐç ÇäÕêÚÉ: <informalexample> <programlisting role="php"><![CDATA[ <?php function &find_var ($param) { ...code... return $found_var; } $foo =& find_var ($bar); $foo->x = 2; ?> ]]></programlisting> </informalexample> áé çÐÇ ÇäåËÇä¬ êÊå ÊÙêêæ ÎÇÕêÉ ÇäãÇÆæ ÇäÐê ÊåÊ ÇÙÇÏÊç ÈèÇÓ×É ÇäÏÇäÉ <varname>find_var</varname> èäêÓ æÓÎÉ åæç ãåÇ Óêãèæ ÇäÍÇä ÈÏèæ ÇÓÊÎÏÇå ÕêÚÉ ÇäåÑÌÙ. </para> <note> <simpara> Ùäé ÙãÓ ÊåÑêÑ ÇäåÄÔÑÇʬ êÌÈ Ùäêã ÇÓÊÎÏÇå <literal>&amp;</literal> áé ÇäåãÇæêæ - ääÅêÖÇÍ Ãæñã Êâèå ÈÇäÅÑÌÇÙ ÙÈÑ ÇäåÑÇÌÙ èäêÓ æÓÎÉ ãåÇ çè åÙÊÇϬ èääÅêÖÇÍ ÃêÖÇ Ãæñç ÈÏäÇ åæ ÇäÊÙêêæ ÇäåÙÊÇϬ êÌÈ ÇäâêÇå ÈÑÈ× åÑÌÙêñ äà <varname>$foo</varname>. </simpara> </note> </sect1> <sect1 id="language.references.unset"> <title>ÇÒÇäÉ ÊÙêêæ ÇäåÑÇÌÙ</title> <para> ÙæÏåÇ Êâèå ÈÅÒÇäÉ ÊÙêêæ ÇäåÑÌÙ¬ áÃæÊ Êâèå áâ× ÈãÓÑ ÇäÑÈ× Èêæ ÇÓå ÇäåÊÚêÑ èåÍÊèé ÇäåÊÚêñí. äÇ êÙæê çÐÇ Ãæñ åÍÊèé ÇäåÊÚêÑ ÓêÊå ÊÏåêÑç. Ùäé ÓÈêä ÇäåËÇä: <informalexample> <programlisting role="php"><![CDATA[ <?php $a = 1; $b =& $a; unset ($a); ?> ]]></programlisting> </informalexample> äæ êÒêä ÊÙêêæ <varname>$b</varname>¬ áâ× <varname>$a</varname>. </para> <simpara> åæ ÌÏêϬ êåãæ Ãæ êãèæ åæ ÇäåáêÏ ÇäÊáãêÑ ÈÎÕèÕ çÐÇ Ùäé Ãæñç ååÇËä äÇÓÊÏÙÇÁ <command>unlink</command> ÇäÎÇÕ Èà Unix. </simpara> </sect1> <sect1 id="language.references.spot"> <title>ãÔá åèÇâÙ ÇäåÑÇÌÙ</title> <simpara> ÇäÙÏêÏ åæ ÈæÇÁÇÊ ÇäÕñðêîÚ áê PHP êÊå ÊæáêÐçÇ ÙÈÑ ÂäêÇÊ åÑÌÙêñÉ ÈÍêË Ãæ ãä åÇ âêä åÓÈâÇ ÈÎÕèÕ ÇäÑÈ× ÇäåÑÌÙêñ êæ×Èâ ÃêÖÇ Ùäé çÐç ÇäÈæÇÁÇÊ. ÈÙÖ ÇäÈæÇÁÇʬ åËä ÇäÊåÑêÑ èÇäÅÑÌÇÙ ÙÈÑ ÇäåÑÇÌÙ¬ âÏ Êå ÇäÊ×Ñâ ÅäêçÇ áê ÇäÃÙäé. ÈæÇÁÇÊ ÃÎÑé ÊÓÊÎÏå åÑÇÌÙ çê: </simpara> <sect2 id="references.global"> <title> ÇäåÑÇÌÙ <literal>ÇäÔÇåäÉ</literal></title> <para> ÙæÏåÇ ÊïÕÑñðÍ Ùæ åÊÚêÑ Ùäé Ãæñç <command>global $var</command>¬ áÅæñ㬠áê ÇäèÇâÙ¬ ÈÕÏÏ ÅæÔÇÁ åÑÌÙ äåÊÚêñÑ ÔÇåä. êÙæê çÐÇ Ãæ ÇäÃåÑ çè æáÓç åËä: <informalexample> <programlisting role="php"><![CDATA[ <?php $var =& $GLOBALS["var"]; ?> ]]></programlisting> </informalexample> </para> <simpara> êÙæê çÐǬ Ùäé ÓÈêä ÇäåËÇä¬ Ãæ ÅÒÇäÉ ÊÙêêæ <varname>$var</varname> äæ êÄÏê Åäé ÅÒÇäÉ ÊÙêêæ åÊÚêÑ ÔÇåä. </simpara> </sect2> <sect2 id="references.this"> <title> <literal>$this</literal> </title> <simpara> áê ×ÑêâÉ ãÇÆæêñɬ <varname>$this</varname> çè ÏÇÆåÇë åÑÌÙ ääãÇÆæ ÇäåæÇÏêñ. </simpara> </sect2> </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 -->
« previous php.doc.ar (#531) next »