goba Sun Aug 19 13:06:17 2001 EDT
Modified files:
/phpdoc/hu/language references.xml
/phpdoc/hu Translators
Log:
Adding references XML, now translated to Hungarian
Index: phpdoc/hu/language/references.xml
diff -u /dev/null phpdoc/hu/language/references.xml:1.4
--- /dev/null Sun Aug 19 13:06:17 2001
+++ phpdoc/hu/language/references.xml Sun Aug 19 13:06:17 2001
@@ -0,0 +1,335 @@
+<?xml encoding="iso-8859-2"?>
+
+ <chapter id="language.references">
+ <title>Referenci�k</title>
+
+ <sect1 id="language.references.whatare">
+ <title>Mik a referenci�k</title>
+ <simpara>
+ A referenci�k lehet�s�get adnak PHP-ben azonos v�ltoz�
+ tartalom el�r�s�re k�l�nb�z� nevek alatt. Ezek szimb�lumt�bla
+ bejegyz�sek, nem olyanok, mint a C nyelv mutat�i. PHP-ben
+ a v�ltoz�k neve �s tartalma k�t k�l�nb�z� dolog, teh�t
+ ugyanaz a tartalom kaphat k�l�nb�z� neveket. A legjobb
+ hasonlat tal�n a UNIX �llom�nynevek �s �llom�nyok rendszere.
+ A v�ltoz�neveket k�nyvt�r bejegyz�sekk�nt foghatod fel,
+ a v�ltoz�k tartalm�t �llom�nyokk�nt. A referenci�k olyanok,
+ mint UNIXban a hardlinkek.
+ </simpara>
+ </sect1>
+
+ <sect1 id="language.references.whatdo">
+ <title>Mit lehet referenci�kkal tenni</title>
+ <para>
+ A PHP referenci�k lehet�s�get adnak arra, hogy egy �rt�khez
+ k�t nevet redelj. Ez azt jelenti, hogy amikor a k�vetkez�t
+ teszed:
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+$a =& $b;
+]]>
+ </programlisting>
+ </informalexample>
+ az <varname>$a</varname> �s <varname>$b</varname>
+ nevek ugyanarra az �rt�kre hivatkoznak.
+ <note>
+ <para>
+ Az <varname>$a</varname> �s a <varname>$b</varname> nevek
+ teljesen egyenrang�ak. Nem arr�l van sz�, hogy az
+ <varname>$a</varname> a <varname>$b</varname>-re mutat,
+ vagy ford�tva, hanem arr�l, hogy az <varname>$a</varname>
+ �s a <varname>$b</varname> n�v ugyanannak az �rt�knek
+ k�t elnevez�se.
+ </para>
+ </note>
+ </para>
+ <para>
+ Ugyanez a forma haszn�lhat� az olyan f�ggv�nyekn�l, amik
+ referenci�t adnak vissza, vagy a <literal>new</literal>
+ oper�tor haszn�latakor (a PHP 4.0.4 �s k�s�bbi verzi�kban):
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+$obj =& new valamilyen_osztaly();
+$ize =& valtozo_kereses ($valami);
+]]>
+ </programlisting>
+ </informalexample>
+ </para>
+ <note>
+ <para>
+ Ha nem a fenti m�dszert alkalmazod, az
+ <literal>$obj = new valamilyen_osztaly()</literal>
+ k�ddal kapott $obj nem ugyanaz az �rt�k lesz,
+ mint a <literal>$this</literal> a konstruktorban. Teh�t
+ ha a <literal>$this</literal> referenci�t haszn�l�d a
+ konstruktorban, referencia hozz�rendel�st kell alkalmaznod,
+ k�l�nben k�t k�l�nb�z� objektummal dolgozol.
+ </para>
+ </note>
+ <para>
+ A c�m szerinti param�ter�tad�s a m�sik dolog, amit
+ referenci�kkal el lehet �rni. Ezzel a h�vott f�ggv�ny
+ egy lok�lis v�ltoz�ja �s a h�v� k�rnyezet egy v�ltoz�ja
+ ugyanazt az �rt�ket jelentik. P�ld�ul:
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+function ize (&$valtozo)
+{
+ $valtozo++;
+}
+
+$a = 5;
+ize ($a);
+]]>
+ </programlisting>
+ </informalexample>
+ Ez a k�d az <varname>$a</varname> v�ltoz� �rt�k�t 6-ra �ll�tja.
+ Ez az�rt t�rt�nik meg, mivel az <varname>ize</varname> f�ggv�nyben
+ a <varname>$valtozo</varname> egy referencia az
+ <varname>$a</varname> v�ltoz� �rt�k�re.
+ L�sd m�g a r�szletes le�r�st a <link
+ linkend="language.references.pass">c�m szerinti �tad�sr�l</link>.
+ </para>
+ <simpara>
+ A harmadik dolog, amit referenci�kkal tehetsz, az a <link
+ linkend="language.references.return">c�m szerinti visszet�r�s</link>.
+ </simpara>
+ </sect1>
+
+ <sect1 id="language.references.arent">
+ <title>Mit nem lehet referenci�kkal tenni</title>
+ <para>
+ Mint kor�bban �rtuk, a referenci�k nem mutat�k. Ez azt
+ jelenti, hogy a k�vetkez� konstrukci� nem azt teszi,
+ amit elv�rn�l:
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+function ize (&$valtozo)
+{
+ $valtozo =& $GLOBALS["valami"];
+}
+ize($valami);
+]]>
+ </programlisting>
+ </informalexample>
+ </para>
+ <simpara>
+ A <varname>foo</varname> f�ggv�nyben a <varname>$valtozo</varname>
+ v�ltoz� a <varname>$valami</varname> �rt�k�hez lesz k�tve,
+ de ut�na ezt megv�ltoztatjuk a <varname>$GLOBALS["valami"]</varname>
+ �rt�k�re. Nincs lehet�s�g <varname>$valami</varname> k�t�s�re
+ a h�v� k�rnyezetben valami m�shoz a referenci�k seg�ts�g�vel,
+ mivel <varname>$valami</varname> nem �ll rendelkez�sre az
+ <varname>ize</varname> f�ggv�nyben (ott a <varname>$valtozo</varname>
+ reprezent�lja az �rt�k�t, de a <varname>$valtozo</varname> csak
+ v�ltoz� tartalommal b�r �s nem n�v-�rt�k k�t�ssel a h�v� szimb�lum
+ t�bl�j�ban).
+ </simpara>
+ </sect1>
+
+ <sect1 id="language.references.pass">
+ <title>C�m szerinti param�ter�tad�s</title>
+ <para>
+ �t tudsz adni f�ggv�nyeknek v�ltoz�kat c�m szerinti
+ form�ban is, �gy a f�ggv�ny tudja m�dos�tani az �rt�ket.
+ Ez a k�vetkez�k�ppen haszn�latos:
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+function ize (&$valtozo)
+{
+ $valtozo++;
+}
+
+$a = 5;
+ize ($a);
+// $a itt 6
+]]
+ </programlisting>
+ </informalexample>
+ Figyeld meg, hogy nincs referencia jelz�s h�v�skor, csak
+ a f�ggv�ny defin�ci�j�ban. Ez �nmag�ban el�g a megfelel�
+ m�k�d�shez.
+ </para>
+ <para>
+ A k�vetkez�ket adhatod �t c�m szerint:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ V�ltoz�, p�ld�ul <literal>ize($a)</literal>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ New utas�t�s, p�ld�ul <literal>ize(new osztaly())</literal>
+ </simpara>
+ </listitem>
+ <listitem>
+ <para>
+ Egy f�ggv�ny �ltal visszaadott referencia, p�ld�ul:
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+function &valami()
+{
+ $a = 5;
+ return $a;
+}
+ize(valami());
+]]>
+ </programlisting>
+ </informalexample>
+ L�sd m�g a <link linkend="language.references.return">c�m
+ szerinti visszet�r�s</link> le�r�s�t.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ Minden m�s kifejez�st ker�lni kell c�m szerinti
+ param�ter�tad�skor, mivel az eredm�nyek nem defini�ltak.
+ P�ld�ul a k�vetkez� p�ld�ja a c�m szerinti param�ter�tad�snak
+ hib�s:
+ <informalexample>
+ <programlisting role="php">
+<![VDATA[
+function valami() // Figyeld meg a hi�nyz� & jelet
+{
+ $a = 5;
+ return $a;
+}
+ize(valami());
+
+ize($a = 5) // Kifejez�s, nem v�ltoz�
+ize(5) // Konstans, nem v�ltoz�
+]]>
+ </programlisting>
+ </informalexample>
+ Ezek a meghat�roz�sok a PHP 4.0.4 �s k�s�bbi verzi�ira �rv�nyesek.
+ </para>
+ </sect1>
+
+ <sect1 id="language.references.return">
+ <title>C�m szerinti visszat�r�s</title>
+ <para>
+ A c�m szerinti visszat�r�s akkor hasznos, ha meg kell tal�lnod
+ egy v�ltoz�t amire referenci�t szeretn�l k�sz�teni. Ha
+ referenci�val szeretn�l visszat�rni, haszn�ld az al�bbi form�t:
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+function &valtozo_kereses ($param)
+{
+ ...k�d...
+ return $megtalalt_valtozo;
+}
+
+$ize =& valtozo_kereses ($valami);
+$ize->x = 2;
+]]>
+ </programlisting>
+ </informalexample>
+ Ebben a p�ld�ban a <varname>valtozo_kereses</varname>
+ egy objektumot keres meg, �s a megtal�lt objektum
+ egy tulajdons�g�t �ll�tjuk �t - helyesen, a m�solat�nak
+ egy tulajdons�ga helyett, amit a referenci�k haszn�lata
+ n�lk�l tett�nk volna - hib�san.
+ </para>
+ <note>
+ <simpara>
+ A param�ter �tad�ssal ellent�tben, itt a
+ <literal>&</literal> jelet mindk�t helyen meg kell
+ adnod, a c�m szerinti visszat�r�s jel�l�s�hez. �gy nem
+ egy m�solatot kapsz, �s az <varname>$ize</varname> v�ltoz�ra
+ n�zvereferencia hozz�rendel�s t�rt�nik, nem �rt�k hozz�rendel�s.
+ </simpara>
+ </note>
+ </sect1>
+
+ <sect1 id="language.references.unset">
+ <title>Referenci�k megsz�ntet�se</title>
+ <para>
+ Amikor megsz�ntetsz egy referenci�t, csak megszak�tod
+ a v�ltoz� n�v �s �rt�k k�z�tti kapcsolatot. Ez nem
+ azt jelenti, hogy a v�lt�z� �rt�k�t t�rl�d. P�ld�ul:
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+$a = 1;
+$b =& $a;
+unset ($a);
+]]>
+ </programlisting>
+ </informalexample>
+ nem fogja megsz�ntetni a <varname>$b</varname> nevet, csak
+ az <varname>$a</varname> nevet, �gy az �rt�k a
+ <varname>$b</varname> n�ven tov�bbra is el�rhet�.
+ </para>
+ <simpara>
+ Ism�t �rdemes a Unix <command>unlink</command> parancs�val
+ �s az �llom�nyrendszerrel val� hasonlatoss�gra gondolni.
+ </simpara>
+ </sect1>
+
+ <sect1 id="language.references.spot">
+ <title>A PHP �ltal haszn�lt referenci�k</title>
+ <simpara>
+ Sok konstrukci� a PHPben referenci�k seg�ts�g�vel
+ val�sul meg, az�rt minden fentebb t�rgyalt k�rd�s
+ ezekre az elemekre is igaz. N�h�ny olyan konstrukci�t,
+ mint a c�m szerinti param�ter �tad�st vagy visszat�r�st
+ m�r kifejtett�nk, m�s referenci�kat haszn�l� konstrukci�k:
+ </simpara>
+
+ <sect2 id="references.global">
+ <title><literal>global</literal> referenci�k</title>
+ <para>
+ Amikor egy v�ltoz�t a <command>global $valtozo</command> form�val
+ glob�lisk�nt haszn�lsz, tulajdonk�ppen egy referenci�t k�pzel
+ a megfelel� glob�lis v�ltoz�ra. Ez azt jelenti, hogy a k�vetkez�
+ k�dnak megfelel� t�rt�nik:
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+$valtozo =& $GLOBALS["valtozo"];
+]]>
+ </programlisting>
+ </informalexample>
+ </para>
+ <simpara>
+ Ez p�ld�ul azt is jelenti, hogy a <varname>$valtozo</varname>
+ t�rl�se nem fogja t�r�lni a glob�lis v�ltoz�t.
+ </simpara>
+ </sect2>
+
+ <sect2 id="references.this">
+ <title><literal>$this</literal></title>
+ <simpara>
+ Egy objektum met�dusban a <varname>$this</varname>
+ mindig az aktu�lis p�ld�nyra egy referencia.
+ </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
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
Index: phpdoc/hu/Translators
diff -u phpdoc/hu/Translators:1.44 phpdoc/hu/Translators:1.45
--- phpdoc/hu/Translators:1.44 Sun Aug 19 10:21:30 2001
+++ phpdoc/hu/Translators Sun Aug 19 13:06:17 2001
@@ -184,7 +184,7 @@
functions.xml Kontra Gergely 1.15
oop.xml Kontra Gergely 1.5 ++
operators.xml Kontra Gergely 1.26
-references.xml Kontra Gergely [undrcon]
+references.xml Hojtsy G�bor 1.14
types.xml Hojtsy G�bor 1.45
variables.xml Kontra Gergely 1.17
-------- pear ---------------------------------------------------------------
