cvs: phpdoc-he / translation.xml /language functions.xml references.xml

Index: phpdoc-he/language/functions.xml
diff -u phpdoc-he/language/functions.xml:1.1 phpdoc-he/language/functions.xml:1.2
--- phpdoc-he/language/functions.xml:1.1	Mon Jul 28 04:53:30 2003
+++ phpdoc-he/language/functions.xml	Tue Jul 29 06:13:54 2003
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="WINDOWS-1255"?>
-<!-- $Revision: 1.1 $ -->
-<!-- orginal-Revision: 1.40 -->
+<!-- $Revision: 1.2 $ -->
+<!-- EN-Revision: 1.40 Maintainer: momo Status: done -->
  <chapter id="functions">
   <title>ôåð÷öéåú</title>
 
Index: phpdoc-he/translation.xml
diff -u phpdoc-he/translation.xml:1.34 phpdoc-he/translation.xml:1.35
--- phpdoc-he/translation.xml:1.34	Mon Jul 28 07:45:38 2003
+++ phpdoc-he/translation.xml	Tue Jul 29 06:13:55 2003
@@ -40,7 +40,6 @@
   <file name="reference/datetime/*"	person="momo"		type="translation"	revision="1.0" date="01/06/2003" />
   <file name="reference/strings/*"		person="shimi"		type="translation"	revision="1.0" date="26/05/2003" />
   <file name="reference/sqlite/*"		person="noam"		type="translation"	revision="1.0" date="28/07/2003" />
-  <file name="language/references.xml*"	person="momo"		type="translation"	revision="1.0" date="28/07/2003" />
  </work-in-progress>
 
 </translation>

Index: phpdoc-he/language/references.xml
+++ phpdoc-he/language/references.xml
<?xml version="1.0" encoding="WINDOWS-1255"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.25 Maintainer: momo Status: done -->

 <chapter id="language.references">
  <title>äáðú øéôøðñ ìòåî÷</title>

  <sect1 id="language.references.whatare">
   <title>îä æä øéôøðñ</title>
   <simpara>  
    øéôøðñ áPHP îùîòåúå, âéùä ìàåúå îùúðä áùí àçø. àìå ìà îöáéòéí ëáùôú C,
    àìå ëéðåééí ìòøê áèáìàú ñîìéí. ùéí ìá ùáPHP ùîåú äòøëéí îåôøãéí îúåëðí åòì ëï ìòøê îñåééí éëåìéí ìäéåú ëîä ùîåú.
    ëãé ìäáéï àú äðåùà, àúä éëåì ìçùåá òì òøëé äîùúðéí ëòì ÷áöé îòøëú ääôòìä ùì UNIX ùí ðéúï ì÷ùø áéï îé÷åí îñåééí 
    ìðúéá òì äãéñ÷, áòåã ùúåëï ä÷åáõ òöîå àéððå úìåé á"îñìåì" áå àúä ðîöà.
   </simpara>
  </sect1>

  <sect1 id="language.references.whatdo">
   <title>îä øéôøðñéí òåùéí?</title>
   <para>
    øéôøðñ îàôùø ìùðé îùúðéí ìäöáéò òì àåúå úåëï. ëìåîø ëùàúä òåùä:
    <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 is 6 here
?>
]]>
     </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() // Note the missing &
{
    $a = 5;
    return $a;
}
foo(bar());

foo($a = 5) // Expression, not variable
foo(5) // Constant, not variable
?>
]]>
     </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
-->