cvs: phpdoc-hu /language functions.xml

From: Date: Tue, 03 Aug 2004 13:10:12 +0000
Subject: cvs: phpdoc-hu /language functions.xml
Groups: php.doc.hu 
Request: Send a blank email to doc-hu+get-756@lists.php.net to get a copy of this message
bagilevi Tue Aug 3 09:10:12 2004 EDT Modified files: /phpdoc-hu/language functions.xml Log: sync

http://cvs.php.net/diff.php/phpdoc-hu/language/functions.xml?r1=1.18&r2=1.19&ty=u Index: phpdoc-hu/language/functions.xml diff -u phpdoc-hu/language/functions.xml:1.18 phpdoc-hu/language/functions.xml:1.19 --- phpdoc-hu/language/functions.xml:1.18 Sun Aug 25 08:52:04 2002 +++ phpdoc-hu/language/functions.xml Tue Aug 3 09:10:12 2004 @@ -1,25 +1,31 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.28 Maintainer: goba Status: ready --> -<!-- CREDITS: kgergely,gerzson --> +<!-- EN-Revision: 1.50 Maintainer: goba Status: ready --> +<!-- CREDITS: kgergely,gerzson,bagilevi --> - <chapter id="functions"> + <chapter id="language.functions"> <title>Függvények</title> <sect1 id="functions.user-defined"> <title>Felhasználó által definiált függvények</title> <para> - Függvényeket a következõ szintaxis szerint definiálhatod: <informalexample> - <programlisting role="php"> + Függvényeket a következõ szintaxis szerint definiálhatod: + </para> + <para> + <example> + <title>Pseudo code to demonstrate function uses</title> + <programlisting role="php"> <![CDATA[ -function foo ($arg_1, $arg_2, ..., $arg_n) +<?php +function foo($arg_1, $arg_2, /* ..., */, $arg_n) { echo "Példa függvény.\n"; return $retval; } +?> ]]> </programlisting> - </informalexample> + </example> </para> <simpara> @@ -29,15 +35,94 @@ definíciók is. </simpara> <simpara> - PHP 3-ban a függvényeket definiálni kell, mielõtt hivatkozás történik rájuk - (függvényhívás elõtt). - PHP 4-ben nincs ez a megkötés. + PHP 3-ban a függvényeket definiálni kell, mielõtt hivatkozás + történik rájuk (függvényhívás elõtt). + PHP 4-tõl nincs ez a megkötés, <emphasis>kivéve</emphasis> amikor + egy függvény feltételesen van definiálva, mint ahogy az alábbi két + példa mutatja. </simpara> + <para> + When a function is defined in a conditional manner such as the two + examples shown. Its definition must be processed <emphasis>prior</emphasis> + to being called. + </para> + <para> + <example> + <title>Feltételesen definiált függvények</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$izet_definialni = true; + +/* Innen nem tudjuk meghívni az ize() függvényt mivel még nem létezik, + viszont a bigyo() függvényt meghívhatjuk */ + +bigyo(); + +if ($izet_definialni) { + function ize() + { + echo "Én nem létezem mígnem a program futása eljut hozzám.\n"; + } +} + +/* Most nyugodtan meghívhatjuk az ize() függvenyt, + abban az esetben, ha az $izet_definialni változó értéke true */ + +if ($izet_definialni) ize(); + +function bigyo() +{ + echo "Én létezek már a program futásának megkezdésekor is..\n"; +} + +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Függvények függvényekben</title> + <programlisting role="php"> +<![CDATA[ +<?php +function ize() +{ + function bigyo() + { + echo "Én nem létezek amíg az ize() nincs meghívva.\n"; + } +} + +/* Itt nem hívhatjuk meg a bigyo() függvényt + mivel még nem létezik. */ + +ize(); + +/* Itt már meghívhatjuk a bigyo()-t, + mivel az ize() függvény feldolgozása + elérhetõvé tette. */ + +bigyo(); + +?> +]]> + </programlisting> + </example> + </para> <simpara> A PHP nem támogatja a függvények polimorfizmusát (többalakúságát), a - függvényekdefiníciókat nem lehet megszüntetni vagy újradefiniálni egy - már definiált függvényeket. + függvényekdefiníciókat nem lehet megszüntetni vagy már definiált + függvényeket újradefiniálni. </simpara> + <note> + <simpara> + A függvénynevek nem érzékenyek a kis- és nagybetûkre, bár rendszerint + jó gyakorlat olyan formában meghívni õket, ahogyan deklaráltuk. + </simpara> + </note> <simpara> A PHP 3 nem támogatja a változó számú függvényargumentumokat, bár az argumentumok kezdõértéke támogatott. Lásd az @@ -59,26 +144,31 @@ ami egy vesszõvel határolt változó és/vagy konstanslista. </simpara> <para> - A PHP támogatja az érték szerinti (ez az alapértelmezett) - <link linkend="functions.arguments.by-reference">referenciakénti - paraméterátadást</link> is, és az <link - linkend="functions.arguments.default">argumentumok kezdõértékét</link>. - A változó hosszúságú argumentumlisták csak a PHP 4-ben jelentek meg. - Lásd a <link linkend="functions.variable-arg-list">változó - hosszúságú argumentumlistákat</link> és a <function>func_num_args</function>, - <function>func_get_arg</function> és a <function>func_get_args</function> - függvényeket részletesebb leírásért. PHP 3-ban hasonló hatás érhetõ el - a függvénynek tömb típusú változó paraméterként történõ átadásával: - <informalexample> - <programlisting role="php"> + A PHP támogatja az érték szerinti (ez az alapértelmezett) + <link linkend="functions.arguments.by-reference">referenciakénti + paraméterátadást</link> is, és az <link + linkend="functions.arguments.default">argumentumok kezdõértékét</link>. + A változó hosszúságú argumentumlisták csak a PHP 4-ben jelentek meg. + Lásd a <link linkend="functions.variable-arg-list">változó + hosszúságú argumentumlistákat</link> és a <function>func_num_args</function>, + <function>func_get_arg</function> és a <function>func_get_args</function> + függvényeket részletesebb leírásért. PHP 3-ban hasonló hatás érhetõ el + a függvénynek tömb típusú változó paraméterként történõ átadásával: + </para> + <para> + <example> + <title>Tömb átadása függvénynek</title> + <programlisting role="php"> <![CDATA[ +<?php function tombot_kezel($input) { echo "$input[0] + $input[1] = ", $input[0]+$input[1]; } +?> ]]> </programlisting> - </informalexample> + </example> </para> <sect2 id="functions.arguments.by-reference"> @@ -95,9 +185,13 @@ Ha egy függvényargumentum mindig referencia szerint kell átadni, akkor a függvénydefinícióban az argumentum neve elé egy &amp; jelet kell írni. - <informalexample> - <programlisting role="php"> + </para> + <para> + <example> + <title>Referencia szerinti paraméterátadás</title> + <programlisting role="php"> <![CDATA[ +<?php function fgv_extrakkal(&$string) { $string .= 'és a szükséges plusssz.'; @@ -105,9 +199,10 @@ $str = 'Ez egy karakterfüzér, '; fgv_extrakkal($str); echo $str; // kiírja, hogy 'Ez egy karakterfüzér, és a szükséges plusssz.' +?> ]]> </programlisting> - </informalexample> + </example> </para> </sect2> @@ -117,78 +212,119 @@ <para> Bármely függvény skalár-argumentumainak megadhatsz kezdõértéket a C++ szintaxisnak megfelelõen: - <informalexample> - <programlisting role="php"> + </para> + <para> + <example> + <title>Alapértelmezett paraméterek használata függvényekben</title> + <programlisting role="php"> <![CDATA[ -function kavet_csinal ($tipus = "cappucino") +<?php + +function kavet_csinal($tipus = "cappucino") { return "Csinálok egy pohár " . $tipus . "t.\n"; } -echo kavet_csinal (); -echo kavet_csinal ("espresso"); +echo kavet_csinal(); +echo kavet_csinal("espresso"); + +?> ]]> </programlisting> - </informalexample> + </example> </para> <para> A fenti kód kimenete: + </para> + <para> <screen> Csinálok egy pohár cappucinot. Csinálok egy pohár espressot. </screen> </para> - + <para> + A PHP azt is megengedi, hogy tömböt vagy a speciális NULL típust + használd alapértelmezett értékként. Például: + </para> + <para> + <example> + <title>Nem-skaláris értékek használata alapértelmezett értékként</title> + <programlisting role="php"> +<![CDATA[ +<?php +function kavet_foz($tipusok = array("cappuccino"), $kaveFozo = NULL) +{ + $eszkoz = is_null($kaveFozo) ? "kézzel" : $kaveFozo; + return "Fõzök egy csésze ".join(", ", $tipusok)." $eszköz.\n"; +} +echo kavet_foz(); +echo kavet_foz(array("cappuccino", "lavazza"), "teafõzõvel"); +?> +]]> + </programlisting> + </example> + </para> <simpara> A kezdõértéknek konstans kifejezésnek kell lennie, nem lehet - pl. változó vagy objektum. + változó, objektum vagy függvényhívás. </simpara> <para> Figyelj arra, hogy a kezdõértékkel rendelkezõ argumentumok más argumentumoktól jobbra helyezkedjenek el; különben a dolgok nem úgy mennek majd, ahogy azt várnád [hanem úgy, ahogy írtad :)]. Lásd a következõ kódot: - <informalexample> + </para> + <para> + <example> + <title>Az alapértelmezett függvényargumentumok helytelen használata</title> <programlisting role="php"> <![CDATA[ -function joghurtot_keszit ($type = "acidophilus", $flavour) +<?php +function joghurtot_keszit($type = "acidophilus", $flavour) { return "Készítek egy köcsög $flavour ízû $type-t.\n"; } -echo joghurtot_keszit ("eper"); // nem úgy mûködik, mint szeretnéd !?!? +echo joghurtot_keszit("eper"); // nem úgy mûködik, mint szeretnéd !?!? +?> ]]> </programlisting> - </informalexample> + </example> </para> - <para> A fenti példa kimenete: + </para> + <para> <screen> Warning: Missing argument 2 in call to joghurtot_keszit() in /usr/local/etc/httpd/htdocs/phptest/functest.php on line 41 Készítek egy köcsög ízû eper-t. </screen> </para> - <para> Most hasonlítsd össze az alábbival: - - <informalexample> - <programlisting role="php"> + </para> + <para> + <example> + <title>Az alapértelmezett függvényargumentumok helyes használata</title> + <programlisting role="php"> <![CDATA[ -function joghurtot_keszit ($flavour, $type = "acidophilus") +<?php +function joghurtot_keszit($flavour, $type = "acidophilus") { return "Készítek egy köcsög $flavour ízû $type-ot.\n"; } -echo joghurtot_keszit ("eper"); // ez már jó +echo joghurtot_keszit("eper"); // ez már jó +?> ]]> </programlisting> - </informalexample> + </example> </para> <para> A fenti példa kimenete: + </para> + <para> <screen> Készítek egy eper ízû acidophilus-t. </screen> @@ -239,17 +375,22 @@ és az objektumokat is. A függvény végrehajtása azonnal befejezõdik, és a vezérlés visszakerül a függvényhívás utáni pozícióba. További részletes információkért lásd: <function>return</function>! - <informalexample> + </para> + <para> + <example> + <title>A <function>return</function> használata</title> <programlisting role="php"> <![CDATA[ -function negyzete ($num) +<?php +function negyzete($num) { return $num * $num; } -echo negyzete (4); // kiírja '16'. +echo negyzete(4); // kiírja '16'. +?> ]]> </programlisting> - </informalexample> + </example> <note> <simpara> [Ha nincs return, az utolsó kifejezés értékével tér viszsza a függvény] @@ -260,34 +401,44 @@ <para> Több értéket nem tud visszaadni a függvény, de hasonló hatás érhetõ el ezen többszörös értékek listába szervezésével. - <informalexample> + </para> + <para> + <example> + <title>Összetett adatok tömbként történõ visszatérítése</title> <programlisting role="php"> <![CDATA[ +<?php function kis_szamok() { - return array (0, 1, 2); + return array(0, 1, 2); } -list ($nulla, $egy, $ketto) = kis_szamok(); +list($nulla, $egy, $ketto) = kis_szamok(); +?> ]]> </programlisting> - </informalexample> + </example> </para> <para> Ha a függvénynek referenciával kell visszatérnie, akkor az &amp; referencia operátort kell alkalmaznod a függvény deklarásákor és a a visszatérési érték megadásakor is. - <informalexample> + </para> + <para> + <example> + <title>Referencia visszatérítése</title> <programlisting role="php"> <![CDATA[ +<?php function &referenciat_ad_vissza() { return &$valtozo; } $hivatkozas = &referenciat_ad_vissza(); +?> ]]> </programlisting> - </informalexample> + </example> </para> <simpara> További információkért lásd a <link @@ -295,32 +446,6 @@ </simpara> </sect1> - <sect1 id="functions.old-syntax"> - <title><literal>old_function</literal></title> - - <simpara> - Az <literal>old_function</literal> kifejezés lehetõvé teszi - függvény deklarálását a PHP/FI2 szintakszisnak megfelelõen - (kivéve persze, hogy a 'function'-t ki kell cserélned 'old_function'-ra) - </simpara> - <simpara> - Ez egy ellenjavallt tulajdonság, és csak a PHP/FI2->PHP 3 konverter - használhatja. - </simpara> - <warning> - <para> - Az <literal>old_function</literal> segítségével deklarált függvényeket - nem hívhatod a PHP belsõ részébõl. Több minden mellett ez azt jelenti, hogy - nem használhatod olyan függvényekben, mint az - <function>usort</function>, <function>array_walk</function>, és a - <function>register_shutdown_function</function>. - Ez a korlátozás megkerülhetõ egy olyan keretfüggvény megírásával (normál PHP 3 formában), - amely meghívja az <literal>old_function</literal>-t. - </para> - </warning> - - </sect1> - <sect1 id="functions.variable-functions"> <title>Függvényváltozók</title> @@ -334,9 +459,12 @@ <para> A függvényváltozók nem fognak mûködni az olyan nyelvi elemekkel, mint - például az <function>echo</function>, <function>unset</function>, - <function>isset</function>, <function>empty</function> vagy - <function>include</function> és <function>print</function>. + például az <function>echo</function>, <function>print</function>, + <function>unset</function>, <function>isset</function>, + <function>empty</function>, <function>include</function>, + <function>require</function> és hasonlók. + Ahhoz, hogy használhasd ezeket a konstrukciókat függvényváltozóként + definiálnod kell saját csomagolófüggvényeket. </para> <para> @@ -347,29 +475,120 @@ <?php function ize() { - echo "Az ize()-ben<br>\n"; + echo "Az ize()-ben<br />\n"; } function bigyo($param = '') { - echo "A bigyo()-ban; az argumentum:'$param'.<br>\n"; + echo "A bigyo()-ban; az argumentum: '$param'.<br />\n"; +} + +// Ez az echo-nak a csomagolófüggvénye +function echoit($string) +{ + echo $string; } $func = 'ize'; -$func(); +$func(); // Ez meghívja ize()-t + $func = 'bigyo'; -$func('Stex van Boeven'); +$func('Stex van Boeven'); // Ez meghívja bigyo()-t + +$func = 'echoit'; +$func('teszt'); // Ez meghívja az echoit()-ot ?> ]]> </programlisting> </example> </para> - <para> - Lásd még a <link linkend="language.variables.variable"> - változó változókat</link> és a - <function>function_exists</function> függvényt. + <para> + Egy objektum metódusát is meghívhatod a függvényváltozókat használva. + <example> + <title>Metódusváltózó példa</title> + <programlisting role="php"> +<![CDATA[ +<?php +class Ize +{ + function Valtozo() + { + $nev = 'Bigyo'; + $this->$nev(); // Ez meghívja a Bigyo() metódust + } + + function Bigyo() + { + echo "Itt Bigyo!"; + } +} + +$ize = new Ize(); +$fnev = "Valtozo"; +$ize->$fnev(); // Ez meghívja az $ize->Valtozo() -t +?> +]]> + </programlisting> + </example> + </para> + <para> + Lásd még a <function>call_user_func</function>, + <link linkend="language.variables.variable"> + variable variables</link> és <function>function_exists</function> + függvényeket. </para> </sect1> + + <sect1 id="functions.internal"> + <title>Belsõ (beépített) függvények</title> + + <para> + A PHP rengeteg függvényt és konstrukciót biztosít. Ezen kívül + vannak függvények, amelyek bizonyos lefordított PHP kiterjesztéseket + igényelnek, különben "undefined function" (definiálatlan függvény) + fatális hibát okoznak. Például az <link linkend="ref.image">image</link> + függvények használatához (mint például a + <function>imagecreatetruecolor</function>) a PHP + <productname>GD</productname> támogatással kell legyen lefordítva. + Vagy a <function>mysql_connect</function> használatához a PHP-be + bele kell fordítani a <link linkend="ref.mysql">MySQL</link> + támogatást. Sok olyan alapvetõ függvény van, amely minden PHP + verzióban megtalálható, mint például a + <link linkend="ref.strings">string</link> és a + <link linkend="ref.var">változó</link> függvények. + A <function>phpinfo</function> vagy a + <function>get_loaded_extensions</function> függvény kiírja + mely kiterjesztések vannak betöltve a PHP-be. + Sok kiterjesztés van alapértelmezésben engedélyezve. A PHP kézikönyv + kiterjesztések szerint van felosztva. + Egyéb információért a PHP beállításával kapcsolatban lásd még a + <link linkend="configuration">konfiguráció</link>, + <link linkend="installation">telepítés</link>, és a kiterjesztések + különálló fejezeteit. + </para> + <para> + A <link linkend="about.prototypes">Hogyan értelmezzünk egy + függvénydefiníciót (prototípust)</link> címû fejezetben van tárgyalva + hogyan kell értelmezni a függvények kézikönyvben szereplõ leírását. + Fontos megérteni, hogy egy függvény mit ad vissza vagy hogy egy + függvény közvetlenül az átadott értéket módosítja. + Például a <function>str_replace</function> a módosított karakterláncot + adja vissza, miközben a <function>usort</function> magán az átadott + értéken dolgozik. A kézikönyvnek minden oldala sajátos információkat + is tartalmaz a függvényekrõl, mint például a paraméterek, + viselkedésmód változása, visszatérítési értékek siker és sikertelenség + esetén és az információ érvényessége. + Ezen fontos (viszont sokszor hajszálnyi) különbségek ismerete döntõ + jelentõségû lehet helyes PHP kód írásához. + </para> + <para> + Lásd még a <function>function_exists</function>, + <link linkend="funcref">the function reference</link>, + <function>get_extension_funcs</function> és + <function>dl</function> függvényeket. + </para> + </sect1> + </chapter> <!-- Keep this comment at the end of the file
« previous php.doc.hu (#756) next »