cvs: phpdoc-ar /language references.xml

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
-->