cvs: phpdoc /hu/functions apache.xml aspell.xml bc.xml funchand.xml math.xml pcre.xml

pgerzson Fri Dec 21 11:54:41 2001 EDT Modified files: /phpdoc/hu/functions aspell.xml apache.xml funchand.xml math.xml pcre.xml bc.xml Log: typos and minor updates

Index: phpdoc/hu/functions/aspell.xml diff -u phpdoc/hu/functions/aspell.xml:1.7 phpdoc/hu/functions/aspell.xml:1.8 --- phpdoc/hu/functions/aspell.xml:1.7 Sat Dec 15 09:47:01 2001 +++ phpdoc/hu/functions/aspell.xml Fri Dec 21 11:54:40 2001 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.7 Maintainer: goba Status: ready --> -<!-- CREDITS: zvaranka --> +<!-- EN-Revision: 1.21 Maintainer: goba Status: ready --> +<!-- CREDITS: zvaranka,pgerzson --> <reference id="ref.aspell"> - <title>Aspell függvények</title> + <title>Aspell függvények [ellenjavallt]</title> <titleabbrev>Aspell</titleabbrev> <partintro> @@ -30,7 +30,7 @@ <refentry id="function.aspell-new"> <refnamediv> <refname>aspell_new</refname> - <refpurpose>Betölt egy új szótárt</refpurpose> + <refpurpose>Betölt egy új szótárt [ellenjavallt]</refpurpose> </refnamediv> <refsect1> <title>Leírás</title> @@ -38,13 +38,13 @@ <funcprototype> <funcdef>int <function>aspell_new</function></funcdef> <paramdef>string <parameter>master</parameter></paramdef> - <paramdef>string <parameter>personal</parameter></paramdef> + <paramdef>string <parameter><optional>personal</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <simpara> - Az <function>aspell_new</function> megnyit egy új szótárt és - visszaadja a szótárkapcsolat azonosítóját amely a többi - aspell függvényben használható. + Az <function>aspell_new</function> megnyit egy új szótárt, és + visszaadja a szótárkapcsolat azonosítóját, amely a többi + aspell függvényben használható. Hiba esetén &false;-szal tér vissza. </simpara> <para> <example> @@ -62,25 +62,25 @@ <refentry id="function.aspell-check"> <refnamediv> <refname>aspell_check</refname> - <refpurpose>Ellenõriz egy szót</refpurpose> + <refpurpose>Ellenõriz egy szót [ellenjavallt]</refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>boolean <function>aspell_check</function></funcdef> + <funcdef>bool <function>aspell_check</function></funcdef> <paramdef>int <parameter>dictionary_link</parameter></paramdef> <paramdef>string <parameter>word</parameter></paramdef> </funcprototype> </funcsynopsis> <simpara> Az <function>aspell_check</function> ellenõrzi egy szó helyesírását - és TRUE-t ad vissza, ha a helyesírás korrekt, egyébkét FALSE-ot. + és &true;-t ad vissza, ha a helyesírás jó, egyébként &false;-ot. </simpara> <para> <example> <title><function>aspell_check</function> példa</title> - <programlisting> + <programlisting role="php"> <![CDATA[ $aspell_link=aspell_new ("english"); if (aspell_check ($aspell_link, "testt")) { @@ -99,14 +99,14 @@ <refnamediv> <refname>aspell_check_raw</refname> <refpurpose> - Ellenõriz egy szót, úgy, hogy nem próbálja ki a változatait + Ellenõriz egy szót kis- és nagybetûk cseréje illetve a szöveg trimmelése nélkül [ellenjavallt] </refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>boolean <function>aspell_check_raw</function></funcdef> + <funcdef>bool <function>aspell_check_raw</function></funcdef> <paramdef>int <parameter>dictionary_link</parameter></paramdef> <paramdef>string <parameter>word</parameter></paramdef> </funcprototype> @@ -114,8 +114,8 @@ <simpara> Az <function>aspell_check_raw</function> ellenõrzi egy szó helyesírását anélkül, hogy manipulálná (megváltoztatná a kis- és - nagybetûket vagy levágná a stringet), és TRUE-t ad vissza, - ha a szó helyesírása korrekt, egyébként FALSE-ot. + nagybetûket vagy levágná a stringet), és &true;-t ad vissza, ha a + helyesírás jó, egyébként &false;-ot. </simpara> <para> <example> @@ -138,7 +138,7 @@ <refentry id="function.aspell-suggest"> <refnamediv> <refname>aspell_suggest</refname> - <refpurpose>Egy szó helyesírására tesz javaslatot</refpurpose> + <refpurpose>Egy szó helyesírására tesz javaslatot [ellenjavallt]</refpurpose> </refnamediv> <refsect1> <title>Leírás</title> @@ -158,13 +158,13 @@ <title><function>aspell_suggest</function> példa</title> <programlisting role="php"> <![CDATA[ -$aspell_link=aspell_new ("english"); +$aspell_link = aspell_new("english"); if (!aspell_check ($aspell_link, "test")) { - $suggestions=aspell_suggest ($aspell_link, "test"); + $javaslatok = aspell_suggest($aspell_link, "test"); - for ($i=0; $i &lt; count ($suggestions); $i++) { - echo "Lehetséges helyesírási változatok:: " . $suggestions[$i] . "&lt;br>"; + foreach ( $javaslatok as $javaslat ) { + echo "Lehetséges helyesírási változatok:: " . $javaslat . "&lt;br>"; } } ]]> Index: phpdoc/hu/functions/apache.xml diff -u phpdoc/hu/functions/apache.xml:1.7 phpdoc/hu/functions/apache.xml:1.8 --- phpdoc/hu/functions/apache.xml:1.7 Sun Dec 16 20:33:36 2001 +++ phpdoc/hu/functions/apache.xml Fri Dec 21 11:54:40 2001 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.20 Maintainer: pgerzson Status: ready --> -<!-- CREDITS: zvaranka --> +<!-- EN-Revision: 1.20 Maintainer: goba Status: ready --> +<!-- CREDITS: zvaranka,pgerzson --> <reference id="ref.apache"> <title>Apache-specifikus függvények</title> @@ -23,7 +23,7 @@ </funcsynopsis> <para> Végrehajt egy részleges kérést a meghatározott URI-re és visszatér - ennek összes információjával. Elég messze elmegy ahhoz hogy megszerezze + ennek összes információjával. Elég messze elmegy ahhoz, hogy megszerezze az összes információt az adott forrásról és visszaadja ezeket egy osztályban. A visszaadott osztály tulajdonságai: <simplelist> @@ -106,7 +106,7 @@ Az <function>ascii2ebcdic</function> egy Apache-specifikus függvény, és csak EBCDIC alapú operációs rendszereken érhetõ el (OS/390, BS2000). Egy ASCII kódolt <parameter>ascii_str</parameter> szöveget alakít - át az annak megfelelõ EBCDIC reprezentációvá (biary safe módon). + át az annak megfelelõ EBCDIC reprezentációvá (binary safe módon). Visszatérési értéke az eredmény. </para> <para> @@ -133,7 +133,7 @@ Az <function>ebcdic2ascii</function> egy Apache-specifikus függvény, és csak EBCDIC alapú operációs rendszereken érhetõ el (OS/390, BS2000). Egy EBCDIC kódolt <parameter>ebcdic_str</parameter> szöveget alakít - át az annak megfelelõ ASCII reprezentációvá (biary safe módon). + át az annak megfelelõ ASCII reprezentációvá (binary safe módon). Visszatérési értéke az eredmény. </para> <para> @@ -212,9 +212,9 @@ </funcprototype> </funcsynopsis> <para> - A <function>virtual</function> egy Apache-specifikus függvény amely + A <function>virtual</function> egy Apache-specifikus függvény, amely megegyezik a mod_include &lt;!--#include virtual...--&gt; megoldásával. - Végrehajt egy Apache allekérést. Ez hasznos CGI szkriptek vagy + Végrehajt egy Apache alkérést. Ez hasznos CGI szkriptek vagy .shtml fájlok beillesztésénél, vagy bármi másnál, amit egyébként az Apache dolgozott volna fel. Fontos a CGI szkripteknél, hogy a szkript érvényes CGI fejléceket generáljon. Ezt azt jelenti, hogy Index: phpdoc/hu/functions/funchand.xml diff -u phpdoc/hu/functions/funchand.xml:1.8 phpdoc/hu/functions/funchand.xml:1.9 --- phpdoc/hu/functions/funchand.xml:1.8 Sat Dec 15 09:53:46 2001 +++ phpdoc/hu/functions/funchand.xml Fri Dec 21 11:54:40 2001 @@ -7,11 +7,11 @@ <partintro> <para> - E függvények mindegyike különféle, a PHP függvényekhez szorosan + E függvények mindegyike különféle, a PHP függvényekhez szorosan kapcsolodó mûveletekben segédkezik. </para> </partintro> - + <refentry id="function.call-user-func-array"> <refnamediv> <refname>call_user_func_array</refname> @@ -23,20 +23,20 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>mixed + <funcdef>mixed <function>call_user_func_array</function> </funcdef> - <paramdef>string + <paramdef>string <parameter>function_name</parameter> </paramdef> - <paramdef>array + <paramdef>array <parameter><optional>paramarr</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - A <parameter>function_name</parameter>-ban megadott nevû felhasználói - függvényt hívja meg <parameter>paramarr</parameter>-ben megadott + A <parameter>function_name</parameter>-ban megadott nevû felhasználói + függvényt hívja meg <parameter>paramarr</parameter>-ben megadott paraméterekkel. Például: <informalexample> @@ -74,7 +74,7 @@ </note> </refsect1> </refentry> - + <refentry id="function.call-user-func"> <refnamediv> <refname>call_user_func</refname> @@ -86,33 +86,33 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>mixed + <funcdef>mixed <function>call_user_func</function> </funcdef> - <paramdef>string + <paramdef>string <parameter>function_name</parameter> </paramdef> - <paramdef>mixed + <paramdef>mixed <parameter><optional>parameter</optional></parameter> </paramdef> - <paramdef>mixed + <paramdef>mixed <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - A <parameter>function_name</parameter>-ban megadott nevû felhasználói - függvényt hívja meg. Az ezután álló <parameter>parameter</parameter> + A <parameter>function_name</parameter>-ban megadott nevû felhasználói + függvényt hívja meg. Az ezután álló <parameter>parameter</parameter> paraméterek a megadott sorrendben lesznek átadva a meghívott függvénynek. Nézzük a kövekezõ példát: <informalexample> <programlisting role="php"> <![CDATA[ -function brobely ($type) { - print " Szóval $type akar, semmi gond."; +function borbely ($tipus) { + print " Szóval $tipus akar, semmi gond."; } -call_user_func ('barber', "gomba frizurát"); -call_user_func ('barber', "nyírást"); +call_user_func ('borbely', "gomba frizurát"); +call_user_func ('borbely', "nyírást"); ]]> </programlisting> </informalexample> @@ -125,7 +125,7 @@ </para> </refsect1> </refentry> - + <refentry id="function.create-function"> <refnamediv> <refname>create_function</refname> @@ -142,15 +142,15 @@ </funcsynopsis> <para> Az átadott paraméterek alapján egy anonim - név nélküli függvényt hoz létre. - Az <parameter>args</parameter> paramétert általában egyszeres idézõjelek - közt szokás átadni, és ez ajánlott a <parameter>code</parameter>-ra is. - Ennek az az oka, hogy így az egyszeres idézõjelek közé fogott sztringekre - nem aktiválódik a változó-behelyettesítés, máskülönben macskakörmök + Az <parameter>args</parameter> paramétert általában egyszeres idézõjelek + közt szokás átadni, és ez ajánlott a <parameter>code</parameter>-ra is. + Ennek az az oka, hogy az egyszeres idézõjelek közé fogott sztringekre + nem aktiválódik a változó-behelyettesítés, máskülönben macskakörmök használata esetén a változó neveket visszaperjelezned kellene, mint például: <literal>\$avar</literal>. </para> <para> - Ezzel a függvénnyel - például futási idõben nyert információk alapján - + Ezzel a függvénnyel - például futási idõben nyert információk alapján - definiálhatsz új függvényeket: <example> <title> @@ -161,17 +161,17 @@ $ujfgv = create_function('$a,$b','return "ln($a) + ln($b) = ".log($a * $b);'); echo "Új névtelen függvényünk: $ujfgv\n"; // azért valami neve csak van :) echo $ujfgv(2,M_E)."\n"; -// eredménye +// eredményül kírja: // Új névtelen függvényünk: lambda_1 // ln(2) + ln(2.718281828459) = 1.6931471805599 ]]> </programlisting> </example> Vagy egy általános kezelõfüggvény megléte esetén mûveletek sorozata alkalmazható - egy adott paraméterlistára, pl: + egy adott paraméterlistára, pl: <example> <title> - Általános feldolgozó függvény létrehozása + Általános feldolgozó függvény létrehozása <function>create_function</function>-nel. </title> <programlisting role="php"> @@ -186,76 +186,76 @@ $f2 = "return \"min(b^2+a, a^2,b) = \".min(\$a*\$a+\$b,\$b*\$b+\$a);"; $f3 = 'if ($a > 0 && $b != 0) {return "ln(a)/b = ".log($a)/$b;} else {return false;}'; $fv_tomb = array( - create_function('$x,$y', 'return "ezt nem tudom mi: ".(sin($x) + $x*cos($y));'), - create_function('$x,$y', 'return "az átfogó: ".sqrt($x*$x + $y*$y);'), - create_function('$a,$b', $f1), - create_function('$a,$b', $f2), - create_function('$a,$b', $f3) + create_function('$x,$y', 'return "ezt nem tudom, mi: ".(sin($x) + $x*cos($y));'), + create_function('$x,$y', 'return "az átfogó: ".sqrt($x*$x + $y*$y);'), + create_function('$a,$b', $f1), + create_function('$a,$b', $f2), + create_function('$a,$b', $f3) ); -echo "\nAz elso tomb anonim fuggvenyekkel\n"; -echo "parameterek: 2.3445, M_PI\n"; +echo "\nAz elsõ tömb anonim függvényekkel\n"; +echo "paraméterek: 2.3445, M_PI\n"; feldolgoz(2.3445, M_PI, $fv_tomb); // most egy csomó sztringkezelõ függvény létrehozása $fv_tomb2 = array( - create_function('$b,$a','if (strncmp($a,$b,3) == 0) return "** \"$a\" '. - 'es \"$b\"\n** nekem azonosnak tunik! (az elso 3 karakter utan)";'), - create_function('$a,$b','; return "CRCs: ".crc32($a)." , ".crc32(b);'), - create_function('$a,$b','; return "similar(a,b) = ".similar_text($a,$b,&$p)."($p%)";') + create_function('$b,$a','if (strncmp($a,$b,3) == 0) return "** \"$a\" '. + 'és \"$b\"\n** nekem azonosnak tûnik! (az elsõ 3 karakter után)";'), + create_function('$a,$b','; return "CRCs: ".crc32($a)." , ".crc32(b);'), + create_function('$a,$b','; return "hasonló(a,b) = ".similar_text($a,$b,&$p)."($p%)";') ); -echo "\nA masodik tomb anonim fuggvenyekkel\n"; -feldolgoz("Akkor csillogo es fenyes volt.", "Akkor este volt.", $fv_tomb2); +echo "\nA második tömb anonim függvényekkel\n"; +feldolgoz("Akkor csillogó és fényes volt.", "Akkor este volt.", $fv_tomb2); ]]> - </programlisting> + </programlisting> </example> a fenti kód lefuttatása után a következõ fog megjelenni: <informalexample> <programlisting> <![CDATA[ -Az elso tomb anonim fuggvenyekkel -parameterek: 2.3445, M_PI -ezt nem tudom mi: -1.6291725057799 +Az elsõ tömb anonim függvényekkel +paraméterek: 2.3445, M_PI +ezt nem tudom, mi: -1.6291725057799 az átfogó: 3.9199852871011 b*a^2 = 4.8103313314525 min(b^2+a, a^2,b) = 8.6382729035898 ln(a/b) = 0.27122299212594 -A masodik tomb anonim fuggvenyekkel -** "Akkor csillogo es fenyes volt." es "Akkor este volt." +A második tömb anonim függvényekkel +** "Akkor csillogó és fényes volt." és "Akkor este volt." ** nekem azonosnak tunik! (az elso 3 karakter utan) CRCs: -725381282 , 1908338681 -similar(a,b) = 11(45.833333333333%) +hasonló(a,b) = 11(45.833333333333%) ]]> </programlisting> </informalexample> - Valószínûleg az anonim függvények legáltalánosabb felhasználási módja az - ún. 'callback' függvények létrehozása, pl. az <function>array_walk</function> vagy - az <function>usort</function> számára. + Valószínûleg az anonim függvények legáltalánosabb felhasználási módja az + ún. 'callback' függvények létrehozása, pl. az <function>array_walk</function> vagy + az <function>usort</function> számára. <example> <title>Anonim függvények használata 'callback' függvényként</title> <programlisting role="php"> <![CDATA[ -$nevelok = array("a ","egy ","az ","ez "); -array_walk($nevelok, create_function('&amp;$v,$k','$v = $v."mango";')); +$nevelok = array("a ","egy ","az ","ez "); +array_walk($nevelok, create_function('&$v,$k','$v = $v."mangó";')); print_r($av); // PHP 3-soknak var_dump() -// kiirja, hogy : +// kiírja, hogy : // Array // ( -// [0] => a mango -// [1] => egy mango -// [2] => az mango -// [3] => ez mango +// [0] => a mangó +// [1] => egy mangó +// [2] => az mangó +// [3] => ez mangó // ) -// szrtinggel teli tömb a rövidebbtõl a hosszabb felé rendezve +// szrtinggel teli tömb a rövidebbtõl a hosszabb felé rendezve $sv = array("rovid","hosszabb","egy nagy string","ez valami sztring dolog"); print_r($sv); // kiírja, hogy: // Array // ( // [0] => rovid -// [1] => hosszabb +// [1] => hosszabb // [2] => egy nagy sztring // [3] => ez valami sztring dolog // ) @@ -292,10 +292,10 @@ </funcprototype> </funcsynopsis> <simpara> - Visszadja a függvénynek átadott paraméterlista <parameter>arg_num</parameter>. - helyén álló paramétert. A paraméterek számozása 0-tól kezdõdik. - A <function>func_get_arg</function> "nem fatális" hibát (warning) jelez, - ha függvényen kívül hívod meg. + Visszadja a függvénynek átadott paraméterlista <parameter>arg_num</parameter>. + helyén álló paramétert. A paraméterek számozása 0-tól kezdõdik. + A <function>func_get_arg</function> "nem fatális" hibát (warning) jelez, + ha függvényen kívül hívod meg. </simpara> <simpara> Ha az <parameter>arg_num</parameter> a pillanatnyilag átadott paraméterek @@ -313,7 +313,7 @@ if ($parameterek_szama >= 2) { echo "A második paraméter: " . func_get_arg (1) . "<br/>\n"; } -} +} ize (1, 2, 3); ?> @@ -322,10 +322,10 @@ </informalexample> </para> <simpara> - A <function>func_get_arg</function> a <function>func_num_args</function> - és a <function>func_get_args</function> függvényekkel együtt olyan - függvények írását segítik elõ, amelyek különbözõ hosszúságú - paraméterlistákat képesek kezelni. + A <function>func_get_arg</function> a <function>func_num_args</function> + és a <function>func_get_args</function> függvényekkel együtt olyan + függvények írását segítik elõ, amelyek különbözõ hosszúságú + paraméterlistákat képesek kezelni. </simpara> <note> <simpara> @@ -351,9 +351,9 @@ </funcprototype> </funcsynopsis> <simpara> - Visszaad egy tömböt az aktuális függvénynek átadott paraméterekkel. - A <function>func_get_args</function> "nem fatális" hibát (warning) jelez, - ha függvénydefiníción kívül hívod meg. + Visszaad egy tömböt az aktuális függvénynek átadott paraméterekkel. + A <function>func_get_args</function> "nem fatális" hibát (warning) jelez, + ha függvénydefiníción kívül hívod meg. </simpara> <para> <informalexample> @@ -370,7 +370,7 @@ for ($i = 0; $i < $pm_szama; $i++) { echo "$i. parameter : " . $pm_lista[$i] . "<br/>\n"; } -} +} ize (1, 2, 3); ?> @@ -379,9 +379,9 @@ </informalexample> </para> <simpara> - A <function>func_get_args</function>-t a <function>func_get_arg</function> és - <function>func_num_args</function> függvényekkel együtt használva a felhasználói - függvények is képesek kezelni a változó hosszúságú paraméterlistákat. + A <function>func_get_args</function>-t a <function>func_get_arg</function> és + <function>func_num_args</function> függvényekkel együtt használva a felhasználói + függvények is képesek kezelni a változó hosszúságú paraméterlistákat. </simpara> <note> <simpara> @@ -407,9 +407,9 @@ </funcprototype> </funcsynopsis> <simpara> - Visszaadja az aktuális függvénynek átadott paraméterek számát. - A <function>func_num_args</function> "nem fatális" hibát (warning) jelez, - ha függvénydefiníción kívül hívod meg. + Visszaadja az aktuális függvénynek átadott paraméterek számát. + A <function>func_num_args</function> "nem fatális" hibát (warning) jelez, + ha függvénydefiníción kívül hívod meg. </simpara> <para> <informalexample> @@ -419,7 +419,7 @@ function ize() { $pm_szama = func_num_args(); echo "A parameterek szama: {$pm_szama}\n"; -} +} ize (1, 2, 3); // kiírja, hogy : 'A parameterek szama: 3' ?> @@ -428,9 +428,9 @@ </informalexample> </para> <simpara> - A <function>func_num_args</function>-t a <function>func_get_arg</function> és - <function>func_get_args</function> függvényekkel együtt használva a felhasználói - függvények is képesek kezelni a változó hosszúságú paraméterlistákat. + A <function>func_num_args</function>-t a <function>func_get_arg</function> és + <function>func_get_args</function> függvényekkel együtt használva a felhasználói + függvények is képesek kezelni a változó hosszúságú paraméterlistákat. </simpara> <note> <simpara> @@ -456,8 +456,8 @@ </funcprototype> </funcsynopsis> <para> - A definiált függvények listájában megkeresi a <parameter>function_name</parameter> nevût, - és &true;-val tér vissza, ha az adott nevû függvényt megtalálta, egyébként &false;-szal. + A definiált függvények listájában megkeresi a <parameter>function_name</parameter> nevût, + és &true;-val tér vissza, ha az adott nevû függvényt megtalálta, egyébként &false;-szal. <informalexample> <programlisting role="php"> <![CDATA[ @@ -467,9 +467,9 @@ echo "IMAP függvények _nem_ használhatók.<br/>\n"; } ]]> - </programlisting> + </programlisting> </informalexample> - Vigyázz, mert egy függvény neve létezhet, még akkor is ha a függvény maga nem használható + Vigyázz, mert egy függvény neve létezhet, még akkor is ha a függvény maga nem használható valamilyen konfigurációs vagy fordítási beálltás következtében. </para> <para> @@ -494,11 +494,11 @@ </funcprototype> </funcsynopsis> <para> - Ez a függvény egy többdimenziós tömböt ad vissza, amelyben mind a beépített - mind a felhasználó által definiált függvények nevei szereplnek. A beépített - függvények nevei <varname>$arr["internal"]</varname>-n keresztül érhetõk el, - amelyeket a felhasználó definiált pedig a <varname>$arr["user"]</varname>-n keresztül. - (lásd a lenti példát) + Ez a függvény egy többdimenziós tömböt ad vissza, amelyben mind a beépített + mind a felhasználó által definiált függvények nevei szereplnek. A beépített + függvények nevei <varname>$arr["internal"]</varname>-n keresztül érhetõk el, + amelyeket a felhasználó definiált, azok pedig az + <varname>$arr["user"]</varname>-n keresztül. (lásd a lenti példát) <informalexample> <programlisting role="php"> <![CDATA[ @@ -561,22 +561,22 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int + <funcdef>int <function>register_shutdown_function</function> </funcdef> <paramdef>string <parameter>func</parameter></paramdef> </funcprototype> </funcsynopsis> <simpara> - A <parameter>func</parameter> nevû függvényt regisztrálja, + A <parameter>func</parameter> nevû függvényt regisztrálja, hogy az majd a szkript feldolgozása után lefusson.</simpara> <para> Gyakori hiba: </para> <simpara> Mivel ebben a függvényben semmilyen adatot nem küldhetsz már a kliens felé, - ezért hibakeresés gyanánt nem használhatsz olyan utasításokat, - mint a print vagy az echo. + ezért hibakeresés gyanánt nem használhatsz olyan utasításokat, + mint a print vagy az echo. </simpara> </refsect1> </refentry> @@ -600,17 +600,17 @@ </funcprototype> </funcsynopsis> <simpara> - Regisztrálja a <parameter>func</parameter> nevû függvényt, hogy az meghívásra kerüljön - minden egyes <link linkend="control-structures.declare">tick</link> bekövetkeztekor. - </simpara> + Regisztrálja a <parameter>func</parameter> nevû függvényt, hogy az meghívásra kerüljön + minden egyes <link linkend="control-structures.declare">tick</link> bekövetkeztekor. + </simpara> </refsect1> </refentry> - + <refentry id="function.unregister-tick-function"> <refnamediv> <refname>unregister_tick_function</refname> <refpurpose> - Megszünteti a függvény futtatását mindenegyes tick bekövetkeztekor + Megszünteti a függvény a tick bekövetkeztekor történõ futtatását </refpurpose> </refnamediv> <refsect1> @@ -629,7 +629,7 @@ linkend="control-structures.declare">tick</link> esemény bekövetkezik.</simpara> </refsect1> </refentry> - + </reference> <!-- Keep this comment at the end of the file Index: phpdoc/hu/functions/math.xml diff -u phpdoc/hu/functions/math.xml:1.9 phpdoc/hu/functions/math.xml:1.10 --- phpdoc/hu/functions/math.xml:1.9 Sat Dec 15 09:53:46 2001 +++ phpdoc/hu/functions/math.xml Fri Dec 21 11:54:40 2001 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2" ?> -<!-- EN-Revision: 1.62 Maintainer: pgerzson Status: ready --> +<!-- EN-Revision: 1.63 Maintainer: pgerzson Status: ready --> <reference id="ref.math"> <title>Matematikai függvények</title> @@ -9,118 +9,117 @@ <sect1 id="math.intro"> <title>Elõszó</title> <para> - Ezek a matematikai függvények csak a gépeden ábrázolható - <type>integer</type> és <type>float</type> típusok értéktartományába - esõ értkeket képes kezelni (ez jelenleg azonos a C beli long és double típusokéval) - Ha nagyobb számokat kell kezelni, akkor a nézd meg a <link - linkend="ref.bc">tetszõleges pontosságú matematikai függvényeket.</link>. + Ezek a matematikai függvények csak a gépeden ábrázolható <type>integer</type> + és <type>float</type> típusok értéktartományába esõ értékeket képes kezelni + (ez jelenleg azonos a C beli long és double típusokéval). Ha nagyobb számokat + kell kezelni, akkor a nézd meg a <link linkend="ref.bc">BCMath tetszõleges pontosságú matematikai függvényeket.</link>. </para> <sect2 id="math.constants"> <title>Matematikai állandók</title> <para> - Ez a matematikai kiterjesztés a következõ értékeket hozza létre a PHP-ban: + Ez a matematikai kiterjesztés a következõ értékeket hozza létre a PHP-ban: <table> <title>Matematikai állandók</title> <tgroup cols="3"> - <thead> - <row> - <entry>Állandó</entry> - <entry>Érték</entry> - <entry>Leírás</entry> - </row> - </thead> - <tbody> - <row> - <entry>M_PI</entry> - <entry>3.14159265358979323846</entry> - <entry>Pi</entry> - </row> - <row> - <entry>M_E</entry> - <entry>2.7182818284590452354</entry> - <entry>e</entry> - </row> - <row> - <entry>M_LOG2E</entry> - <entry>1.4426950408889634074</entry> - <entry>log_2 e</entry> - </row> - <row> - <entry>M_LOG10E</entry> - <entry>0.43429448190325182765</entry> - <entry>log_10 e</entry> - </row> - <row> - <entry>M_LN2</entry> - <entry>0.69314718055994530942</entry> - <entry>log_e 2</entry> - </row> - <row> - <entry>M_LN10</entry> - <entry>2.30258509299404568402</entry> - <entry>log_e 10</entry> - </row> - <row> - <entry>M_PI_2</entry> - <entry>1.57079632679489661923</entry> - <entry>pi/2</entry> - </row> - <row> - <entry>M_PI_4</entry> - <entry>0.78539816339744830962</entry> - <entry>pi/4</entry> - </row> - <row> - <entry>M_1_PI</entry> - <entry>0.31830988618379067154</entry> - <entry>1/pi</entry> - </row> - <row> - <entry>M_2_PI</entry> - <entry>0.63661977236758134308</entry> - <entry>2/pi</entry> - </row> - <row> - <entry>M_SQRTPI</entry> - <entry>1.77245385090551602729</entry> - <entry>sqrt(pi) [4.0.2]</entry> - </row> - <row> - <entry>M_2_SQRTPI</entry> - <entry>1.12837916709551257390</entry> - <entry>2/sqrt(pi)</entry> - </row> - <row> - <entry>M_SQRT2</entry> - <entry>1.41421356237309504880</entry> - <entry>sqrt(2)</entry> - </row> - <row> - <entry>M_SQRT3</entry> - <entry>1.73205080756887729352</entry> - <entry>sqrt(3) [4.0.2]</entry> - </row> - <row> - <entry>M_SQRT1_2</entry> - <entry>0.70710678118654752440</entry> - <entry>1/sqrt(2)</entry> - </row> - <row> - <entry>M_LNPI</entry> - <entry>1.14472988584940017414</entry> - <entry>log_e(pi) [4.0.2]</entry> - </row> - <row> - <entry>M_EULER</entry> - <entry>0.57721566490153286061</entry> - <entry>Euler constant [4.0.2]</entry> - </row> - </tbody> + <thead> + <row> + <entry>Állandó</entry> + <entry>Érték</entry> + <entry>Leírás</entry> + </row> + </thead> + <tbody> + <row> + <entry>M_PI</entry> + <entry>3.14159265358979323846</entry> + <entry>Pi</entry> + </row> + <row> + <entry>M_E</entry> + <entry>2.7182818284590452354</entry> + <entry>e</entry> + </row> + <row> + <entry>M_LOG2E</entry> + <entry>1.4426950408889634074</entry> + <entry>log_2 e</entry> + </row> + <row> + <entry>M_LOG10E</entry> + <entry>0.43429448190325182765</entry> + <entry>log_10 e</entry> + </row> + <row> + <entry>M_LN2</entry> + <entry>0.69314718055994530942</entry> + <entry>log_e 2</entry> + </row> + <row> + <entry>M_LN10</entry> + <entry>2.30258509299404568402</entry> + <entry>log_e 10</entry> + </row> + <row> + <entry>M_PI_2</entry> + <entry>1.57079632679489661923</entry> + <entry>pi/2</entry> + </row> + <row> + <entry>M_PI_4</entry> + <entry>0.78539816339744830962</entry> + <entry>pi/4</entry> + </row> + <row> + <entry>M_1_PI</entry> + <entry>0.31830988618379067154</entry> + <entry>1/pi</entry> + </row> + <row> + <entry>M_2_PI</entry> + <entry>0.63661977236758134308</entry> + <entry>2/pi</entry> + </row> + <row> + <entry>M_SQRTPI</entry> + <entry>1.77245385090551602729</entry> + <entry>sqrt(pi) [4.0.2]</entry> + </row> + <row> + <entry>M_2_SQRTPI</entry> + <entry>1.12837916709551257390</entry> + <entry>2/sqrt(pi)</entry> + </row> + <row> + <entry>M_SQRT2</entry> + <entry>1.41421356237309504880</entry> + <entry>sqrt(2)</entry> + </row> + <row> + <entry>M_SQRT3</entry> + <entry>1.73205080756887729352</entry> + <entry>sqrt(3) [4.0.2]</entry> + </row> + <row> + <entry>M_SQRT1_2</entry> + <entry>0.70710678118654752440</entry> + <entry>1/sqrt(2)</entry> + </row> + <row> + <entry>M_LNPI</entry> + <entry>1.14472988584940017414</entry> + <entry>log_e(pi) [4.0.2]</entry> + </row> + <row> + <entry>M_EULER</entry> + <entry>0.57721566490153286061</entry> + <entry>Euler constant [4.0.2]</entry> + </row> + </tbody> </tgroup> </table> PHP 4RC1 verziójáig csak az M_PI használható. - Minden más állandó PHP 4.0-tól kezdve elérhetõ, kivéve amelyiknél a [4.0.2] címke olvasható: - ezek csak PHP 4.0.2-tól kezdve. + Minden más állandó PHP 4.0-tól kezdve elérhetõ, kivéve amelyiknél a [4.0.2] címke olvasható: + ezek csak PHP 4.0.2-tól kezdve. </para> </sect2> </sect1> @@ -232,8 +231,8 @@ </funcsynopsis> <para> Az <parameter>arg</parameter> area hiperbolikus szinuszával tér vissza, - azzal az értékkel, amelynnek hiperbolikus szinusza egyenlõ az - <parameter>arg</parameter> paraméterrel. + azzal az értékkel, amelynnek hiperbolikus szinusza egyenlõ az + <parameter>arg</parameter> paraméterrel. </para> &note.no-windows; <para> @@ -279,8 +278,8 @@ </funcprototype> </funcsynopsis> <para> - Az <parameter>arg</parameter> area hiperbolikus tangensével tér vissza, - azzal az értékkel, amelynek hiiperbolikus tangense egyenlõ az <parameter>arg</parameter> paraméterrel. + Az <parameter>arg</parameter> area hiperbolikus tangensével tér vissza, + azzal az értékkel, amelynek hiiperbolikus tangense egyenlõ az <parameter>arg</parameter> paraméterrel. </para> &note.no-windows; <para> @@ -306,8 +305,8 @@ </funcsynopsis> <simpara> Ez a függvény az <parameter>x</parameter> és <parameter>y</parameter> által meghatározott érték - arkusz tangensét adja vissza radiánban. Ez hasonló az <parameter>y</parameter> / <parameter>x</parameter> arkusz tangenséhez, - attól eltekintve hogy a paraméterek elõjele meghatározza, hogy az eredmény melyik körnegyedbe esik. + arkusz tangensét adja vissza radiánban. Ez hasonló az <parameter>y</parameter> / <parameter>x</parameter> arkusz tangenséhez, + attól eltekintve hogy a paraméterek elõjele meghatározza, hogy az eredmény melyik körnegyedbe esik. </simpara> <simpara> A függvény eredményét radiánban adja vissza, ami -PI és +PI közé esik (beleértve a határokat is). @@ -334,15 +333,15 @@ </funcprototype> </funcsynopsis> <para> - A <parameter>number</parameter>-ben átadott számot váltja át a <parameter>tobase</parameter>-ben - megadott alapszámú számrendszerbe, és ezzel tér vissza. - A <parameter>number</parameter> alapszáma a <parameter>frombase</parameter>-ben adható meg. - Mind a <parameter>frombase</parameter> és <parameter>tobase</parameter> paraméternek 2 és 36 közé kell esnie. - A 10-nél nagyobb értékû számjegyeket betûkkel ábrázoljuk, ahol az "a" 10-et jelent, a "b" 11-et és a "z" 35-öt. + A <parameter>number</parameter>-ben átadott számot váltja át a <parameter>tobase</parameter>-ben + megadott alapszámú számrendszerbe, és ezzel tér vissza. + A <parameter>number</parameter> alapszáma a <parameter>frombase</parameter>-ben adható meg. + Mind a <parameter>frombase</parameter> és <parameter>tobase</parameter> paraméternek 2 és 36 közé kell esnie. + A 10-nél nagyobb értékû számjegyeket betûkkel ábrázoljuk, ahol az "a" 10-et jelent, a "b" 11-et és a "z" 35-öt. <example> <title><function>base_convert</function></title> <programlisting role="php"> -<![CDATA[ +<![CDATA[ $binaris = base_convert ($hexadecimalis, 16, 2); ]]> </programlisting> @@ -351,7 +350,6 @@ </refsect1> </refentry> - <refentry id="function.bindec"> <refnamediv> <refname>bindec</refname> @@ -366,16 +364,16 @@ </funcprototype> </funcsynopsis> <para> - A <parameter>binary_string</parameter> kettes számrendszerbeli (bináris) szám - tizes számrendszerbeli (decimális) megfelelõjét adja vissza. + A <parameter>binary_string</parameter> kettes számrendszerbeli (bináris) szám + tizes számrendszerbeli (decimális) megfelelõjét adja vissza. </para> <para> A <function>bindec</function> függvény <type>integer</type> típusúvá konvertálja át a - bináris számot. Így a legnagyobb konvertálható szám a 31 db 1 bitbõll álló szám vagyis 2147483647 (10-es számrendszerben). + bináris számot. A legnagyobb konvertálható szám a 31 db 1 bitbõl álló szám, + vagyis 2147483647 (10-es számrendszerben). </para> <para> Lásd még: <function>decbin</function>! - function. </para> </refsect1> </refentry> @@ -396,7 +394,7 @@ <simpara> Ha szükséges, akkor a következõ legnagyobb egész számmal tér vissza a <parameter>value</parameter>-t felfelé kerekítve. A <function>ceil</function> által visszadott érték <type>float</type> típusú, mivel a <type>float</type> értékészlete - általában nagyobb, mint <type>int</type>-é. + általában nagyobb, mint <type>int</type>-é. </simpara> <simpara> Lásd még: <function>floor</function> és <function>round</function>! @@ -464,8 +462,8 @@ </funcprototype> </funcsynopsis> <para> - A <parameter>number</parameter> kettes számrendszerbeli ábrázolását sztringként adja vissza. - A legnagyobb átváltható szám 2147483647 (tízes számrendszerben), ami 31 db 1-esbõl álló sztringet eredményez. + A <parameter>number</parameter> kettes számrendszerbeli ábrázolását sztringként adja vissza. + A legnagyobb átváltható szám 2147483647 (tízes számrendszerben), ami 31 db 1-esbõl álló sztringet eredményez. </para> <para> Lásd még: <function>bindec</function>! @@ -487,8 +485,8 @@ </funcprototype> </funcsynopsis> <para> - A <parameter>number</parameter> tizenhatos számrendszerbeli ábrázolását sztringként adja vissza. - A legnagyobb átváltható szám 2147483647 (tízes számrendszerben), ami "7fffffff"-et ad eredményül. + A <parameter>number</parameter> tizenhatos számrendszerbeli ábrázolását sztringként adja vissza. + A legnagyobb átváltható szám 2147483647 (tízes számrendszerben), ami "7fffffff"-et ad eredményül. </para> <para> Lásd még: <function>hexdec</function>! @@ -510,8 +508,8 @@ </funcprototype> </funcsynopsis> <para> - A <parameter>number</parameter> nyolcas számrendszerbeli ábrázolását sztringként adja vissza. - A legnagyobb átváltható szám 2147483647 (tízes számrendszerben), ami "17777777777"-et ad eredményül. + A <parameter>number</parameter> nyolcas számrendszerbeli ábrázolását sztringként adja vissza. + A legnagyobb átváltható szám 2147483647 (tízes számrendszerben), ami "17777777777"-et ad eredményül. </para> <para> Lásd még: <function>octdec</function>! @@ -563,6 +561,28 @@ </refsect1> </refentry> + <refentry id='function.expm1'> + <refnamediv> + <refname>expm1</refname> + <refpurpose> + exp(number) - 1 pontos értéke, még ha a number 0-hoz közeli értékû is + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>expm1</function></funcdef> + <paramdef>float <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + <refentry id="function.floor"> <refnamediv> <refname>floor</refname> @@ -577,15 +597,16 @@ </funcprototype> </funcsynopsis> <simpara> - Ha szükséges, akkor a megelõzõ legkisebb egész számmal tér vissza a <parameter>value</parameter>-t lefelé kerekítve. - A <function>floor</function> által visszadott érték <type>float</type> típusú, mivel a <type>float</type> értékészlete - általában nagyobb, mint <type>int</type>-é. + Ha szükséges, akkor a megelõzõ legkisebb egész számmal tér vissza a + <parameter>value</parameter>-t lefelé kerekítve. A <function>floor</function> + által visszadott érték <type>float</type> típusú, mivel a <type>float</type> + értékészlete általában nagyobb, mint <type>int</type>-é. </simpara> <example> <title><function>floor</function> példa</title> <programlisting role="php"> <![CDATA[ -$negy = floor(4.3); // $negy = 4.0; +$negy = floor(4.3); // $negy = 4.0; $kilenc = floor(9.999); // $kilenc = 9.0; ]]> </programlisting> @@ -610,7 +631,7 @@ </funcprototype> </funcsynopsis> <simpara> - A legnagyobb lehetséges véletlen számot adja vissza, amit a <function>rand</function> meghívásakor visszaadhat. + A legnagyobb lehetséges véletlen számot adja vissza, amit a <function>rand</function> a meghívásakor visszaadhat. </simpara> <simpara> Lásd még: <function>rand</function>, <function>srand</function>, @@ -634,24 +655,26 @@ </funcprototype> </funcsynopsis> <para> - A tizenhatos számrendszerbeli <parameter>number</parameter> tízes számrendszerbeli megfelelõjével tér vissza. - A legnagyobb átváltható szám a 7fffffff, azaz 2147483647 (tízes számrendszerben). + A tizenhatos számrendszerbeli <parameter>hex_string</parameter> tízes + számrendszerbeli megfelelõjével tér vissza. A legnagyobb átváltható szám + a 7fffffff, azaz 2147483647 (tízes számrendszerben). </para> <para> - A <function>hexdec</function> a <parameter>hex_string</parameter> nem hexadecimális karaktereit - <literal>0</literal>-ra cseréli, és így minden baloldali nullát figyelmen kívül hagy, de a - jobboldaliak beszámítanak az eredménybe. + A <function>hexdec</function> a <parameter>hex_string</parameter> nem + hexadecimális karaktereit <literal>0</literal>-ra cseréli, és minden + baloldali nullát figyelmen kívül hagy, de a jobboldaliak beszámítanak + az eredménybe. <example> <title><function>hexdec</function> példa</title> <programlisting role="php"> <![CDATA[ var_dump(hexdec("hee")); var_dump(hexdec("ee")); -// mindketto: int(238) +// mindkettõ: int(238) var_dump(hexdec("az")); var_dump(hexdec("a0")); -// mindketto: int(160) +// mindkettõ: int(160) ]]> </programlisting> </example> @@ -662,6 +685,29 @@ </refsect1> </refentry> +<refentry id='function.hypot'> + <refnamediv> + <refname>hypot</refname> + <refpurpose> + a sqrt( num1*num1 + num2*num2) értékét adja vissza + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>hypot</function></funcdef> + <paramdef>float <parameter>num1</parameter></paramdef> + <paramdef>float <parameter>num2</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + <refentry id="function.lcg-value"> <refnamediv> <refname>lcg_value</refname> @@ -677,8 +723,8 @@ </funcsynopsis> <para> A <function>lcg_value</function> ál véletlenszámot ad vissza a (0,1) intervallumból. - A függvény két, 2^31 - 85 és 2^31 - 249 periódusú CG-t kombinál, - és a periódusa ennek a két prímnek a szorzatával egyenlõ. + A függvény két, 2^31 - 85 és 2^31 - 249 periódusú CG-t kombinál, + és a periódusa ennek a két prímnek a szorzatával egyenlõ. </para> </refsect1> </refentry> @@ -697,7 +743,7 @@ </funcprototype> </funcsynopsis> <para> - Az <parameter>arg</parameter> természetes (e) alapú logaritmusát adja vissza. + Az <parameter>arg</parameter> természetes (e) alapú logaritmusát adja vissza. </para> </refsect1> </refentry> @@ -721,6 +767,28 @@ </refsect1> </refentry> + <refentry id='function.log1p'> + <refnamediv> + <refname>log1p</refname> + <refpurpose> + log(1 + number) pontos értékét adja vissza, akkor is ha a val értéke 0-hoz közeli + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>log1p</function></funcdef> + <paramdef>float <parameter>number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + <refentry id="function.max"> <refnamediv> <refname>max</refname> @@ -740,15 +808,15 @@ A <function>max</function> a paraméterként átadott, számként értelmezett értékek legnagyobbjával tér vissza. </para> <para> - Ha az elsõ paraméter tömb típusú, akkor a tömbbeli legnagyobb értéket adja vissza. - Ha az elsõ paraméter integer, float vagy string típusú, akkor legalább két paraméterrel - kell meghívni a függvényt, és az a legnagyobb értékû számmal tér vissza. - Korlátlan számú paraméterrel hívható meg ez a függvény. + Ha az elsõ paraméter tömb típusú, akkor a tömbbeli legnagyobb értéket adja vissza. + Ha az elsõ paraméter integer, float vagy string típusú, akkor legalább két paraméterrel + kell meghívni a függvényt, és az a legnagyobb értékû számmal tér vissza. + Korlátlan számú paraméterrel hívható meg ez a függvény. </para> <para> - Ha legalább egy összehasonlítandó érték float típusú, akkor mindegyik float-ként lesz kezelve és a - visszatérési érték is float lesz. Ha egyik sem float, akkor mindegyik integer-ként lesz kezelve, és - a visszatérési érték is integer lesz. + Ha legalább egy összehasonlítandó érték float típusú, akkor mindegyik float-ként lesz kezelve és a + visszatérési érték is float lesz. Ha egyik sem float, akkor mindegyik integer-ként lesz kezelve, és + a visszatérési érték is integer lesz. </para> </refsect1> </refentry> @@ -776,15 +844,15 @@ A <function>min</function> a paraméterként átadott, számként értelmezett értékek legkisebbjével tér vissza. </para> <para> - Ha az elsõ paraméter tömb típusú, akkor a tömbbeli legkisebb értéket adja vissza. - Ha az elsõ paraméter integer, float vagy string típusú, akkor legalább két paraméterrel - kell meghívni a függvényt, és az a legkisebb értékû számmal tér vissza. - Korlátlan számú paraméterrel hívható meg ez a függvény. + Ha az elsõ paraméter tömb típusú, akkor a tömbbeli legkisebb értéket adja vissza. + Ha az elsõ paraméter integer, float vagy string típusú, akkor legalább két paraméterrel + kell meghívni a függvényt, és az a legkisebb értékû számmal tér vissza. + Korlátlan számú paraméterrel hívható meg ez a függvény. </para> <para> - Ha legalább egy összehasonlítandó érték <type>float</type> típusú, akkor mindegyik float-ként lesz kezelve és a - visszatérési érték is float lesz. Ha egyik sem float, akkor mindegyik <type>integer</type>-ként lesz kezelve, és - a visszatérési érték is integer lesz. + Ha legalább egy összehasonlítandó érték <type>float</type> típusú, akkor mindegyik float-ként lesz kezelve és a + visszatérési érték is float lesz. Ha egyik sem float, akkor mindegyik <type>integer</type>-ként lesz kezelve, és + a visszatérési érték is integer lesz. </para> </refsect1> </refentry> @@ -812,35 +880,35 @@ </funcprototype> </funcsynopsis> <simpara> - A régebbi libc-k véletlenszám generátorai kétes vagy bizonytalan - jellegûek és lassúak voltak. Alapértelmezés szerint, a PHP a - libc véletlenszám generátorát használja a <function>rand</function> - függvényben. A <function>mt_rand</function> függvény egy "beugrós" - helyettesítése ennek. Ez egy ismert jellemvonásokkal bíró véletlenszám - generátor, a Mersenne Twister, ami többféle kriptogáfiai eljárás - inicializálásához (seeding) is megfelelõ véletlenszámokat generál - kb. négyszer gyorsabban, mint az átlagos libc rand függvények. - (Részletesebb információkért nézd meg a Mersenne Twister honlapját, amely + A régebbi libc-k véletlenszám generátorai kétes vagy bizonytalan + jellegûek és lassúak voltak. Alapértelmezés szerint, a PHP a + libc véletlenszám generátorát használja a <function>rand</function> + függvényben. A <function>mt_rand</function> függvény egy "beugrós" + helyettesítése ennek. Ez egy ismert jellemvonásokkal bíró véletlenszám + generátor, a Mersenne Twister, ami többféle kriptogáfiai eljárás + inicializálásához (seeding) is megfelelõ véletlenszámokat generál + kb. négyszer gyorsabban, mint az átlagos libc rand függvények. + (Részletesebb információkért nézd meg a Mersenne Twister honlapját, amely <ulink url="&url.mersenne;">&url.mersenne;</ulink> , az MT forrás - optimalizált változata <ulink url="&url.mersenne.twister;">&url.mersenne.twister;</ulink> pedig - címen található. + optimalizált változata <ulink url="&url.mersenne.twister;">&url.mersenne.twister;</ulink> pedig + címen található. </simpara> <simpara> Ha a <parameter>min</parameter> és <parameter>max</parameter> paraméterek - nélkül hívod meg az <function>mt_rand</function> függvényt, akkor - az ál véletlenszám értéke 0 és <constant>RAND_MAX</constant> közé fog esni. - Ha pl. 5 és 15 közé (bezárólag) esõ véletlen számot akarsz kapni, akkor - <literal>mt_rand(5, 15)</literal> kell írni. + nélkül hívod meg az <function>mt_rand</function> függvényt, akkor + az ál véletlenszám értéke 0 és <constant>RAND_MAX</constant> közé fog esni. + Ha pl. 5 és 15 közé (bezárólag) esõ véletlen számot akarsz kapni, akkor + <literal>mt_rand(5, 15)</literal> kell írni. </simpara> <simpara> - Ne felejtsd el a véletlenszám generátor kiinduló értékét beállítani - a <function>mt_srand</function> függvénnyel. + Ne felejtsd el a véletlenszám generátor kiinduló értékét beállítani + a <function>mt_srand</function> függvénnyel. </simpara> <note> <para> A 3.0.7 verziók elõtt a <parameter>max</parameter> paraméter helyett <parameter>range</parameter> (tartomány) - szerepelt. Ezekben a verziókban az elõzõ példával egyenértékû megoldás a <literal>mt_rand (5, 11)</literal>, hogy - 5 és 15 közé esõ véletlen számot kapj. + szerepelt. Ezekben a verziókban az elõzõ példával egyenértékû megoldás a <literal>mt_rand (5, 11)</literal>, hogy + 5 és 15 közé esõ véletlen számot kapj. </para> </note> <simpara> @@ -863,9 +931,9 @@ <funcdef>void <function>mt_srand</function></funcdef> <paramdef>int <parameter>seed</parameter></paramdef> </funcprototype> - </funcsynopsis> + </funcsynopsis> <para> - Beállítja a véletlenszám generátor kiinduló értékét <parameter>seed</parameter>-re. + Beállítja a véletlenszám generátor kiinduló értékét <parameter>seed</parameter>-re. <informalexample> <programlisting role="php"> <![CDATA[ @@ -903,13 +971,13 @@ </funcprototype> </funcsynopsis> <simpara> - Visszaadja azt a legnagyobb véletlenszámot, amit a <function>mt_rand</function> meghívásakor visszadhat. + Visszaadja azt a legnagyobb véletlenszámot, amit az <function>mt_rand</function> a meghívásakor visszadhat. </simpara> <simpara> Lásd még: <function>mt_rand</function>, <function>mt_srand</function>, <function>rand</function>, <function>srand</function> és - <function>getrandmax</function>. + <function>getrandmax</function>! </simpara> </refsect1> </refentry> @@ -932,27 +1000,27 @@ </funcsynopsis> <para> A <function>number_format</function> a <parameter>number</parameter> paraméter formázott értékével tér vissza. - A függvény egy, két vagy négy paramétert fogad el(de hármat nem): + A függvény egy, két vagy négy paramétert fogad el (de hármat nem): </para> <para> - Ha csak egy paraméter van megadva, akkor <parameter>number</parameter> törtrész nélkül, - de ezresenkénti csoportosítással kerül formázásra. ("," választva el a csoportokat) + Ha csak egy paraméter van megadva, akkor <parameter>number</parameter> törtrész nélkül, + de ezresenkénti csoportosítással kerül formázásra. ("," választva el a csoportokat) </para> <para> - Két paraméter esetén a <parameter>number</parameter> a <parameter>decimals</parameter>-ba megadott számú - tizedesre lesz formázva, ponttal (".") a tizedesek elõtt és vesszõvel (",") választva el a csoportokat. + Két paraméter esetén a <parameter>number</parameter> a <parameter>decimals</parameter>-ba megadott számú + tizedesre lesz formázva, ponttal (".") a tizedesek elõtt és vesszõvel (",") választva el a csoportokat. </para> <para> - Négy paraméter esetén a <parameter>number</parameter> a <parameter>decimals</parameter>-ba megadott számú - tizedesre lesz formázva. A tizedesek elõtt a <parameter>dec_point</parameter> áll a pont (".") helyett, - és a <parameter>thousands_sep</parameter> választja el a csoprtokat a vesszõ (",") helyett. + Négy paraméter esetén a <parameter>number</parameter> a <parameter>decimals</parameter>-ba megadott számú + tizedesre lesz formázva. A tizedesek elõtt a <parameter>dec_point</parameter> áll a pont (".") helyett, + és a <parameter>thousands_sep</parameter> választja el a csoprtokat a vesszõ (",") helyett. </para> <note> <para> A <parameter>thousands_sep</parameter>-nak csak az elsõ karakterét használja a függvény. - Például Ha <literal>ize</literal>-t adsz meg mint <parameter>thousands_sep</parameter> - az <literal>1000</literal> szám esetén, akkor <function>number_format</function> - <literal>1i000</literal>-t fog visszaadni. + Például ha <literal>ize</literal>-t adsz meg mint <parameter>thousands_sep</parameter>, akkor + az <literal>1000</literal> számhoz, akkor <function>number_format</function> + <literal>1i000</literal>-t fog visszaadni. </para> </note> <para> @@ -960,8 +1028,8 @@ <title><function>number_format</function> példa</title> <para> Példaként, a francia jelölés általában két tizedest tartalmaz, és - vesszõt használ (',') a tizedesek elválasztására, és szóközzel (' ') - tagolja az egész részt. Ez a következõképpen érhetõ el: + vesszõt használ (',') a tizedesek elválasztására, és szóközzel (' ') + tagolja az egész részt. Ez a következõképpen érhetõ el: </para> <programlisting role="php"> <![CDATA[ @@ -978,7 +1046,7 @@ // 1 234,56 - $number = 1234.5678; + $szam = 1234.5678; // angol jelölés ezresek csoportosítása nélkül $angol_szam_forma = number_format($szam, 2, '.', ''); @@ -1012,9 +1080,8 @@ </funcprototype> </funcsynopsis> <para> - A nyolcas számrendszerbeli <parameter>number</parameter> tízes számrendszerbeli megfelelõjével tér vissza. - A legnagyobb átváltható szám "17777777777", ami 2147483647-et (tízes számrendszerben) ad eredményül. - decimal. + A nyolcas számrendszerbeli <parameter>octdec</parameter> tízes számrendszerbeli megfelelõjével tér vissza. + A legnagyobb átváltható szám "17777777777", ami 2147483647-et (tízes számrendszerben) ad eredményül. </para> <para> Lásd még: <function>decoct</function>! @@ -1025,7 +1092,7 @@ <refentry id="function.pi"> <refnamediv> <refname>pi</refname> - <refpurpose>visszaadja pi(&amp;pi;) értékét</refpurpose> + <refpurpose>visszaadja pi értékét</refpurpose> </refnamediv> <refsect1> <title>Leírás</title> @@ -1066,12 +1133,12 @@ </funcprototype> </funcsynopsis> <para> - A <parameter>base</parameter>-t a <parameter>exp</parameter> hatványra emelt értékével tér vissza. - Ha lehetséges, akkor a függvény visszatérési értéke <type>integer</type> lesz. + A <parameter>base</parameter>-t az <parameter>exp</parameter> hatványra emelt értékével tér vissza. + Ha lehetséges, akkor a függvény visszatérési értéke <type>integer</type> lesz. </para> <para> - Ha a hatványérték nem számítható ki, akkor egy "nem fatális" (warning) hibát jelez - a <function>pow</function> függvény, és &false;-szal tér vissza. + Ha a hatványérték nem számítható ki, akkor egy "nem fatális" (warning) hibát jelez + a <function>pow</function> függvény, és &false;-szal tér vissza. </para> <example> <title>Néhány példa a <function>pow</function> alkalmazására</title> @@ -1081,7 +1148,7 @@ var_dump( pow(2,8) ); // int(256) echo pow(-1,20); // 1 -echo pow(0, 0); // 1 +echo pow( 0, 0); // 1 echo pow(-1, 5.5); // hiba @@ -1092,7 +1159,7 @@ <warning> <para> PHP 4.0.6-ban és korábbi verziókban a <function>pow</function> mindig <type>float</type> típussal tért vissza, - és soha nem jelzett hibát. + és soha nem jelzett hibát. </para> </warning> <para> @@ -1147,20 +1214,20 @@ </funcsynopsis> <simpara> Ha a <parameter>min</parameter> és <parameter>max</parameter> paraméterek - nélkül hívod meg az <function>mt_rand</function> függvényt, akkor - az ál véletlenszám értéke 0 és <constant>RAND_MAX</constant> közé fog esni. - Ha pl. 5 és 15 közé (bezárólag) esõ véletlen számot akarsz kapni, akkor - <literal>mt_rand(5, 15)</literal> kell írni. + nélkül hívod meg az <function>mt_rand</function> függvényt, akkor + az ál véletlenszám értéke 0 és <constant>RAND_MAX</constant> közé fog esni. + Ha pl. 5 és 15 közé (bezárólag) esõ véletlen számot akarsz kapni, akkor + <literal>mt_rand(5, 15)</literal> kell írni. </simpara> <simpara> - Ne felejtsd el a véletlenszám generátor kiinduló értékét beállítani - a <function>srand</function> függvénnyel. + Ne felejtsd el a véletlenszám generátor kiinduló értékét beállítani + a <function>srand</function> függvénnyel. </simpara> <note> <para> A 3.0.7 verziók elõtt a <parameter>max</parameter> paraméter helyett <parameter>range</parameter> (tartomány) - szerepelt. Ezekben a verziókban az elõzõ példával egyenértékû megoldás a <literal>mt_rand (5, 11)</literal>, hogy - 5 és 15 közé esõ véletlen számot kapj. + szerepelt. Ezekben a verziókban az elõzõ példával egyenértékû megoldás a <literal>mt_rand (5, 11)</literal>, hogy + 5 és 15 közé esõ véletlen számot kapj. </para> </note> <simpara> @@ -1189,16 +1256,17 @@ </funcprototype> </funcsynopsis> <para> - A <parameter>val</parameter> paraméter <parameter>precision</parameter>-ban megadott pontosságra - kerekített értékével tér vissza. A <parameter>precision</parameter> a tizedespont után álló - számjegyek számát jelenti. - A <parameter>precision</parameter> nulla vagy negatív szám is lehet. + A <parameter>val</parameter> paraméter <parameter>precision</parameter>-ben + megadott pontosságra kerekített értékével tér vissza. A + <parameter>precision</parameter> a tizedespont után (ill. elõtte) álló + számjegyek számát jelenti. A <parameter>precision</parameter> nulla vagy + negatív szám is lehet. </para> <para> <caution> <simpara> PHP nem kezeli megfelelõen a <literal>"12,300.2"</literal>-hez hasonló sztringeket alapértelmezés szerint. - Lásd <link linkend="language.types.string.conversion">string konverziók</link>. + Lásd <link linkend="language.types.string.conversion">string konverziók</link>. </simpara> </caution> </para> @@ -1265,8 +1333,8 @@ </funcprototype> </funcsynopsis> <para> - Az <parameter>arg</parameter> hiperbolikus szinuszát adja vissza, - amelyet a <literal>(exp(arg) - exp(-arg))/2</literal> kifejezés határoz meg. + Az <parameter>arg</parameter> hiperbolikus szinuszát adja vissza, + amelyet a <literal>(exp(arg) - exp(-arg))/2</literal> kifejezés határoz meg. </para> <para> Lásd még: <function>sin</function>, <function>asinh</function>, @@ -1289,7 +1357,7 @@ </funcprototype> </funcsynopsis> <para> - Az <parameter>arg</parameter> négyzetgzökét adja vissza. + Az <parameter>arg</parameter> négyzetgyökét adja vissza. </para> </refsect1> </refentry> @@ -1308,7 +1376,7 @@ </funcprototype> </funcsynopsis> <para> - Beállítja a véletlenszám generátor kiinduló értékét <parameter>seed</parameter>-re. + Beállítja a véletlenszám generátor kiinduló értékét <parameter>seed</parameter>-re. <informalexample> <programlisting role="php"> <![CDATA[ @@ -1352,8 +1420,8 @@ Lásd még: <function>sin</function> és <function>cos</function>! </para> </refsect1> + </refentry> - </refentry> <refentry id="function.tanh"> <refnamediv> <refname>tanh</refname> @@ -1377,7 +1445,6 @@ </para> </refsect1> </refentry> - </reference> Index: phpdoc/hu/functions/pcre.xml diff -u phpdoc/hu/functions/pcre.xml:1.8 phpdoc/hu/functions/pcre.xml:1.9 --- phpdoc/hu/functions/pcre.xml:1.8 Sat Dec 15 09:53:46 2001 +++ phpdoc/hu/functions/pcre.xml Fri Dec 21 11:54:40 2001 @@ -184,12 +184,12 @@ <para> A <parameter>subject</parameter> szövegben megkeresi az összes, a <parameter>pattern</parameter> mintára illeszkedõ - részt, és a <parameter>matches</parameter> tömbbe menti azokat a + részt, és a <parameter>matches</parameter> tömbbe menti azokat az <parameter>order</parameter> paraméterben meghatározott sorrendben. </para> <para> - Amint az elsõ illeszkedés megtalálta, a soronkövetkezõ illesztés az - utolsó illeszkedéstõl kezdõdik. + Amint az elsõ illeszkedés megtalálta, a soron következõ illesztést az + utolsó illeszkedés végétõl folytatja. </para> <para> Az <parameter>order</parameter> paraméter két értéket vehet fel: @@ -198,9 +198,9 @@ <term>PREG_PATTERN_ORDER</term> <listitem> <para> - Azt eredményezi, hogy a $matches[0] egy tömb lesz, ahol az összes a - teljes mintára illeszkedõ szövegrész lesz egymás után, $matches[1] - tömbben pedig azok a szövegrészek, amelyek elsõ "begyûjtõ" + Azt eredményezi, hogy a $matches[0] olyan tömb lesz, ahol az összes a + teljes mintára illeszkedõ szövegrész lesz egymás után, a $matches[1] + tömbben pedig azok a szövegrészek, amelyek elsõ "gyûjtõ" részmintára illeszkednek, és így tovább. <informalexample> <programlisting role="php"> @@ -232,7 +232,7 @@ <listitem> <para> Azt eredményezi, hogy $matches[0]-ben az elsõ illesztés eredményeit, - a $matches[1] a második eredményeit fogja tartalmazni, és így tovább. + a $matches[1] a másodikét fogja tartalmazni, és így tovább. <informalexample> <programlisting role="php"> <![CDATA[ @@ -286,10 +286,11 @@ <title>HTML elemek keresése (mohón)</title> <programlisting role="php"> <![CDATA[ -// A \\2 példa a hivatkozásra. Ez mondja meg PCRE-nek, hogy a másodikként -// megadott kerek zárójelre - ami ebben az esetben ([\w]+) - illesztett -// szövegnek kell szerepelnie azon a helyen is. A plusz visszaperjelre azért -// van szükség, mert a minta macskakörmök ("") közé van fogva. +// A \\2 példa a "gyûjtõ" részmintára történõ hivatkozásra. Ez mondja meg +// PCRE-nek, hogy a másodikként megadott kerek zárójelre - ami ebben az +// esetben ([\w]+) - illesztett szövegnek kell szerepelnie a hivatkozás +// helyén is. A plusz visszaperjelre azért van szükség, mert a minta +// macskakörmök ("") közé van fogva. $html = "<b>félkövér szöveg</b><a href=howdy.html>kattints ide</a> preg_match_all ("/(<([\w]+)[^<]*>)(.*)(<\/\\2>)/", $html, @@ -350,15 +351,15 @@ <parameter>pattern</parameter> paraméterben megadott mintára illeszkedõ részeket és azokat lecseréli a <parameter>replacement</parameter>-ben megadott kifejezésre. Ha a <parameter>limit</parameter> is szerepel, akkor csak - <parameter>limit</parameter> számú illeszkedõ rész lesz cserélve, - ha <parameter>limit</parameter> hiányzik vagy értéke -1, akkor minden + az elsõ <parameter>limit</parameter> számú illeszkedõ részt cseréli le. + Ha <parameter>limit</parameter> hiányzik vagy értéke -1, akkor minden illeszkedõ részt cserél. </para> <para> A <parameter>replacement</parameter>-ben hivatkozásokat is el lehet helyezni <literal>\\<replaceable>n</replaceable></literal> vagy (PHP 4.0.4-tõl kezdve) <literal><replaceable>$n</replaceable></literal> - alakban(ez utóbbit részesítsd elõnyben). Minden ilyen hivatkozás + alakban (ez utóbbit részesítsd elõnyben). Minden ilyen hivatkozás az <replaceable>n</replaceable>. zárójelezett részminta által megtalált szöveggel lesz helyettesítve. Az <replaceable>n</replaceable> értéke 0-tól 99-ig terjedhet, ahol is a <literal>\\0</literal> vagy @@ -368,7 +369,7 @@ </para> <para> Ha volt egyezés, akkor az új <parameter>subject</parameter>-tel tér - vissza a függvény, egyébként a változatlanul hagyott + vissza a függvény, egyébként a változatlanul hagyott, eredeti <parameter>subject</parameter>-tel. </para> <para> @@ -383,7 +384,7 @@ <para> Ha a <parameter>pattern</parameter> és <parameter>replacement</parameter> paraméterek tömb típusúak, akkor a - <function>preg_replace</function>veszi a tömbök elemeit és mindegyikkel + <function>preg_replace</function> veszi a tömbök elemeit és mindegyikkel páronként elvégzi a keresést és a helyettesítést a <parameter>subject</parameter> szövegen. Ha a <parameter>replacement</parameter> tömbnek a @@ -515,8 +516,8 @@ <function>preg_replace</function> függvényével azt leszámítva, hogy <parameter>replacement</parameter> paraméterként egy <parameter>callback</parameter> függvényt kell megadni, amely minden - sikeres illesztésnél meghívásra kerül, amelynek az illeszkedõ szövegeket egy - tömbben adja át a PHP. A 'meghívott' függvénynek a helyettesítési + sikeres illesztésnél meghívásra kerül. Az illeszkedõ szövegeket egy + tömbben adja át a PHP a 'meghívott' függvénynek, és annak a helyettesítési szöveggel kell visszatérnie. Ez a függvény a PHP 4.0.5-tõl elérhetõ. </para> <para> @@ -561,9 +562,9 @@ <para> Ha a <parameter>limit</parameter> meg van adva, akkor csak - <parameter>limit</parameter> számú darabbal tér vissza. Ha a - <parameter>limit</parameter> értéke -1, az azt jelenti, nincs ilyen - korlát, és ez akkor hasznos, ha a <parameter>flags</parameter> + <parameter>limit</parameter> számú darabbal tér vissza. A + <parameter>limit</parameter> értéke lehet -1 (jelentése: nincs korlát), + és ez akkor hasznos, ha a <parameter>flags</parameter> paraméter értékét is szeretnéd megadni. </para> @@ -685,7 +686,7 @@ // speciális jelentésüktõl. $szoveg = "Ezt a könyvet *nagyon* nehéz megtalálni."; -$szo = "*nagyon*"; +$szo = "*nagyon*"; $szoveg = preg_replace ("/".preg_quote($szo)."/", "<i>".$szo."</i>;", $szoveg); @@ -740,7 +741,7 @@ <refentry id="pcre.pattern.modifiers"> <refnamediv> <refname>Minta módosítók</refname> - <refpurpose>A lehetséges, PCRE reguláris kifejezéseket kiértékelését + <refpurpose>A lehetséges, PCRE reguláris kifejezések kiértékelését befolyásoló módosítók felsorolása</refpurpose> </refnamediv> <refsect1> @@ -861,8 +862,8 @@ <simpara> Ha egy mintát többször használunk, akkor érdemes több idõt hagyni a kiértékelésére, hogy az illesztésre fordított idõ - lerövidülhessen. Ennek a módosítónak a bekapcsolásával ezt többletet - biztosítjuk. Jelenleg, csak olyan nem "rögzített" minták esetén + lerövidülhessen. Ennek a módosítónak a bekapcsolásával ezt biztosítjuk. + Jelenleg, csak olyan nem "rögzített" minták esetén hasznos, amelyek nem egy egyszerû, rögzített karakterrel kezdõdnek. </simpara> </listitem> @@ -1069,9 +1070,9 @@ A reguláris kifejezés maga egy minta, amit a tárgyszövegre kell illeszteni balról jobbra. A karakterek többsége maga helyett áll a mintában, azaz csak saját magára illeszkedik a tárgyszövegben. Egy - egyszerû példán bemutatva az <literal>a gyors vörös róka</literal> minta - a tárgyszöveg azon részére illeszkedik, ami megegyezik vele (azaz ahol a - <literal>a gyors vörös róka</literal> elõfordul. + egyszerû példán bemutatva: az <literal>a gyors vörös róka</literal> minta + a tárgyszöveg azon részére illeszkedik, ami megegyezik vele (azaz ahol az + <literal>a gyors vörös róka</literal> elõfordul). </para> </refsect2> <refsect2 id="regexp.reference.meta"> @@ -1386,8 +1387,8 @@ hogyan használható is ez. </para> <para> - Karakterosztályon belül vagy ha a tízes számrendszerbeli szám nagyobb, - mint 9 és nincs ennyi számú "gyûjtõ" részminta, akkor PCRE újraolvassa a + Karakterosztályon belül vagy ha a tízes számrendszerbeli szám 9-nél nagyobb, + és nincs ennyi számú "gyûjtõ" részminta, akkor PCRE újraolvassa a visszaperjelet követõ három oktális karaktert, és egy bájtra váltja a 8 legkisebb helyiértékû bitet. Bármely rákövetkezõ számjegy maga helyett áll, magára illeszkedik. @@ -1703,8 +1704,8 @@ <title>Szögeletes zárójel []</title> <literallayout> A nyitó szögeletes zárójel egy karakterosztály kezdetét, míg - a záró párja annak végét jelzi. A bezáró zárójel önmagában - nem hordoz speciális jelentést. Ha egy ] karaktert kell a + a záró párja annak végét jelzi. A bezáró zárójel önmagában + nem hordoz speciális jelentést. Ha egy ] karaktert kell a karakterosztályon belül megadni, akkor annak vagy legelöl kell állnia - az esetleges kalap(os ékezet) után -, vagy egy visszaperjelet kell eléírni. @@ -1715,14 +1716,14 @@ karakterek valamelyikére illeszkedik, ha a legelsõ karakter kalap(os ékezet) ^ , akkor pedig csak azokra, amelyek nem elemei az osztálynak. (Ez utóbbit hívjuk tagadó vagy kizáró - karakterosztálynak - a fordító.) Ha a kalap(os ékezet) ^ + karakterosztálynak - a fordító.) Ha a kalap(os ékezet) ^ karaktert kell megadni egy karakterosztály elemeként, akkor - az nem lehet a legelsõ pozicióban, vagy visszaperjelet kell + az nem lehet a legelsõ pozicióban, vagy visszaperjelet kell eléírni. Az [aeiou] karakterosztály például minden kisbetûs ékezet nélküli magánhangzóra illeszkedik, míg az [^aeiou] pont - ezekre nem. A kalap(os ékezet) kényelmes jelölési forma olyan + ezekre nem. A kalap(os ékezet) kényelmes jelölési forma olyan karakterosztályok megadására, ahol a kizárandó elemeket könnyebb felsorolni. Ez nem teszt, ez karaktereket használ el a tárgyszövegbõl, ezért a tárgyszöveg végén az illesztés @@ -1735,9 +1736,9 @@ a kis- és nagybetû különbözõsége számít. Karakterosztályokban az újsort soha nem kezelik különleges - módon, bármi is a <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> és a <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> módosító értéke. - A kizáró karakterosztályok mint például [^a] pedig mindig - illeszkednek az újsor karakterre. + módon, bármi is a <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> és a <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> módosító + értéke. A kizáró karakterosztályok - mint pl.: [^a] - pedig + mindig illeszkednek az újsor karakterre. Az "-" elválasztójellel karaktertartományokat lehet megadni a karakterosztályon belül. A [d-m], például, a d és m közti @@ -1750,18 +1751,18 @@ A "]" karaktert ebben a literális formában nem lehet egy tartomány záró tagjaként használni. A [W-]46] minta például - azt jelenti, hogy a "W" és "-" karakterek valamelyikét - kövesse a "46]" sztring, ezért a "W46]" vagy "-46]" - illeszkedik a mintára. Ha azonban visszaperjelet írunk elé, + azt jelenti, hogy a "W" és "-" karakterek valamelyikét + kövesse a "46]" sztring, ezért a "W46]" vagy a "-46]" + illeszkedik a mintára. Ha azonban visszaperjelet írunk elé, akkor a visszaperjel lesz a tartomány felsõ határa, és ekkor - "[W-\]46]" mintát egy egyszerû osztályként értelmezi, amit + "[W-\]46]" mintát egy egyszerû osztályként értelmezi, amit három különálló karakter követ. Oktális vagy hexadecimális - ábrázolásban lehet megadni a "]"-t mint tartományt lezáró + ábrázolásban lehet megadni a "]"-t mint tartományt lezáró karaktert. - A tartományok meghatározásakor az ASCII karaktertáblázat - karakterkódjai számítanak, a karakterek helyett a numerikus - kódjaik is használhatók, például [\000-\037]. Ha kis- és + A tartományok meghatározásakor az ASCII karaktertáblázat + karakterkódjai számítanak. A karakterek helyett a numerikus + kódjaik is használhatók, például [\000-\037]. Ha kis- és nagybetûkre nem érzékeny az illesztés és a tartomány betûket is felölel, akkor azok mind a kis- mind a nagybetûs alakjuknak megfelelõ karaktereket egyaránt helyettesítik, @@ -1770,7 +1771,7 @@ illeszkedik minden ékezetes e illetve E karakterre. (franciában van pár ilyen :) - A Karakterosztályokhoz karakterfajtákat - \d, \D, \s, \S, \w + A karakterosztályokhoz karakterfajtákat - \d, \D, \s, \S, \w és \W -t - is hozzáadhatunk, és így a fajtába tartozó karaterekkel bõvíthejük. A [\dABCDEF] - például - minden hexadecimális számjegyre illeszkedik . A kalap(os ékezet)-t @@ -1794,21 +1795,20 @@ gyula|sacika minta illeszkedik a "gyula" és a "sacika" szövegre is. - Bármennyi vagylagos / választható mintát fel lehet sorolni, - köztük az üres mintát is, ami az üres sztringre illeszkedik. - Az illesztés a mintákat balról jobbra, egymás után sorjában - veszi, és a legelsõ sikeresen illesztett lesz használva. A - részmintákban használt vagylagos ágak esetében a "sikeresen" - azt jelenti, hogy a minta fennmaradó részét is sikerül - illeszteni. + Bármennyi vagylagos mintát fel lehet sorolni, köztük az üres + mintát is, ami az üres sztringre illeszkedik. Az illesztés a + mintákat balról jobbra, egymás után sorjában veszi, és a + legelsõ sikeresen illesztett lesz használva. A részmintákban + használt vagylagos ágak esetében a "sikeresen" azt jelenti, a + minta fennmaradó részét is sikerül illeszteni. </literallayout> </refsect2> <refsect2 id="regexp.reference.internal-options"> <title>Módosítók mintán belüli beállításai</title> <literallayout> - A <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link> , <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> , <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> és <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> - módosítókat a minta belsejében is átállíthatjuk "(?" és ")" - közé írt Perl-beli betûjelzéseikkel. Ezek a betûk: + A <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link> , <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> , <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> és + <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> módosítókat a minta belsejében is átállíthatjuk + "(?" és ")" közé írt Perl-beli betûjelzéseikkel. Ezek a betûk: i = <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link> m = <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link> @@ -1817,15 +1817,14 @@ A "(?im)" bekapcsolja a többsoros és a "kis-nagybetû mindegy" üzemmódot. Kikapcsolni az egyes beállításokat az eléjük írt - kötõjellel lehet, valamint a módosítók együttes állítása is - megengedett,például a (?im-sx) bekapcsolja a <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link>-t + kötõjellel lehet. Ezenkívül a módosítók együttes állítása is + megengedett, például a (?im-sx) bekapcsolja a <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link>-t és a <link linkend="pcre.pattern.modifiers">PCRE_MULTILINE</link>-t valamint kikapcsolja <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link>-t - és <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link>-t. - Ha egy betûjelzés a kötõjel mindkét oldalán szerepel, akkor - a módosító ki lesz kapcsolva. + és <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link>-t. Ha egy betûjelzés a kötõjel mindkét oldalán + szerepel, akkor a módosító ki lesz kapcsolva. Ezeknek a beállításoknak az érvényességi köre attól függ, - hogy a mintán belül hol fordulnak elõ. Minden részmintán + hogy a mintán belül hol fordulnak elõ. Minden részmintán kívüli beállítás olyan, mintha az illesztés kezdetén lett volna megadva, ezért a következõ minták tökéletesen ugyanúgy mûködnek: @@ -1844,29 +1843,29 @@ Ha részmintán belül történik módosítóváltoztatás, akkor a hatás különbözõ (Perl 5.005 viselkedésbeli változása). - A részmintán belüli módosító-állítás csak a részminta + A részmintán belüli módosító-állítás csak a részminta hátramaradó részét érinti, ezért (a(?i)b)c minta csak az "abc" és "aBc" szövegekre illeszkedik feltéve, hogy <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link> módosítót nem adtuk meg. Ez azt - jelenti, hogy a minta különbözõ helyein a módosítók más és + jelenti, hogy a minta különbözõ helyein a módosítók más és más értékeit lehet beállítani. Bármilyen változtatás egy vagylagos (választható) ágban a következõ ágakra is hatással van ugyanabban a részmintában, például (a(?i)b|c) - minta illeszkedik az "ab", "aB", "c" és "C" szövegekre még + minta illeszkedik az "ab", "aB", "c" és "C" szövegekre még akkor is, ha "C"-re illeszkedve az nem is az elsõ ágra esett a választás, ahol a módosító be lett állítva. Ennek az az - oka, hogy a módosító beállítások hatásai már a kifejezés + oka, hogy a módosító beállítások hatásai már a kifejezés fordításakor / kiértékelésekor rögzülnek, máskülönben néha nagyon furcsa viselkedést tapasztalhatnánk. - A PCRE-specifikus <link linkend="pcre.pattern.modifiers">PCRE_UNGREEDY</link> és <link linkend="pcre.pattern.modifiers">PCRE_EXTRA</link> módosítókat a - Perl-kompatibilisekhez hasonló módon állíthatók, az U és X + A PCRE-specifikus <link linkend="pcre.pattern.modifiers">PCRE_UNGREEDY</link> és <link linkend="pcre.pattern.modifiers">PCRE_EXTRA</link> módosítókat + a Perl-kompatibilisekhez hasonló módon állíthatók, az U és X karakterek használatával.A (?X) beállítás különleges, mert - még a legfelsõ szinten is - mindig hamarabb kell szerepelnie a mintában, mint a további kapcsolóknak. Legjobb a minta @@ -1876,9 +1875,9 @@ <refsect2 id="regexp.reference.subpatterns"> <title>Részminták</title> <literallayout> - A részminták egymásba ágyazhatók, és kerek zárójel fogja - közre õket. A minta egy darabját részmintaként szerepeltetni - két dolgot jelent: + A részminták egymásba ágyazhatók, és kerek zárójel fogja + közre õket. A minta egy darabját részmintaként szerepeltetni + két dolgot jelent: 1. Elágazási lehetõségek helyét jelöli ki (csoportosítás): @@ -1935,19 +1934,20 @@ illeszkedik a "SZERDA" és "Szombat" szavakra is. </literallayout> </refsect2> - <refsect2 id="regexp.reference.repetition"> - <title>ISMÉTLÉSEK</title> + <refsect2 id="regexp.reference.repetition"> + <title>ISMÉTLÉSEK</title> <literallayout> - Az ismétléseket kvantorokkal (sokszorozókkal) lehet megadni - + Az ismétléseket kvantorokkal (sokszorozókkal) lehet megadni + a következõ poziciók után: + egyszerû karakter (esetleg visszaperjellel bevezetve), . metakarakter, karakterosztály, - hivatkozás (következõ szakasz) vagy + hivatkozás (ld. következõ szakasz) vagy zárójeles részminta (nem teszt) - után. - + után. + Az általános ismétlõ kvantor (sokszorozó) - kapcsos zárójelben vesszõvel elválasztva - írja elõ azt minimális és maximális elõfordulási számot, ahányszor a mintát illeszteni @@ -1962,7 +1962,7 @@ szerepel, akkor az illesztésnek nincs felsõ határa, de ha a vesszõt is elhagyjuk, akkor a kvantor (sokszorozó) pontosan a megadott számú illesztést engedi csak. Ekképpen: - + [aáeéiíoóöõuúüû]{3,} legalább 3 egymást követõ magánhangzóra illeszkedik, de akár @@ -1975,44 +1975,44 @@ szerint lesz figyelembe véve, maga helyett áll a mintában. A {,6} például nem kvantor (sokszorozó), hanem egy négy karakteres minta betû szerint értelmezve. - - A {0} kvantor (sokszorozó) megengedett, és hatása olyan, - mintha az elõtte álló mintaelem és maga a kvantor nem is + + A {0} kvantor (sokszorozó) megengedett, és hatása olyan, + mintha az elõtte álló mintaelem és maga a kvantor nem is szerepelne. Kényelmi és történelmi okokból három, gyakori kvantornak létezik rövidítése is: - * egyenlõ {0,} - val - + egyenlõ {1,} - val - ? egyenlõ {0,1} - val + * egyenlõ a {0,} - val + + egyenlõ a {1,} - val + ? egyenlõ a {0,1} - val - Végtelen ciklusokat is lehet definiálni úgy, ha egy olyan - részmintát sokszorozzunk felsõhatár nélkül, amelynek nem + Végtelen ciklusokat is lehet definiálni úgy, ha egy olyan + részmintát sokszorozzunk felsõhatár nélkül, amelynek nem muszáj illeszkednie egyetlen karakterre sem, például: (a?)* - Perl és PCRE korábbi verziói hibát jeleztek az ilyen minták + Perl és PCRE korábbi verziói hibát jeleztek az ilyen minták kiértékelésekor / fordításakor. Azonban vannak esetek,amikor ezek a minták is hasznosak lehetnek, ezért ezeket a mintákat most már elfogadják, de ha a részminták ismételten nem illeszkednek egy karakterre sem, a ciklust erõszakkal - megszakítják. + megszakítják. - Alapértelmezés szerint a kvantorok (sokszorozók) "mohók" , + Alapértelmezés szerint a kvantorok (sokszorozók) "mohók" , azaz amennyi karakterre csak illeszteni tudnak, azt mind - elhasználják a tárgyszövegbõl - a felsõ ismétlési határ - figyelembe vétele mellett - anélkül,hogy a minta többi része - sikertelenül illeszkedne. - A klasszikus példa, ahol ez problémát okoz, a C forráskódok + elhasználják a tárgyszövegbõl a felsõ határ figyelembe vétele + mellett és anélkül, hogy a minta többi része sikertelenül + illeszkedne. + A klasszikus példa, ahol ez problémát okoz, a C forráskódok megjegyzéseire illeszkedõ kifejezés. Ezek a megjegyzések nem egymásba ágyazhatók, /* és */ közé írt tetszõleges szövegek, amelyekben szerepelhet a * és / jel is (nem egymás mellett). /\*.*\*/ - + mintát a /* elsõ megjegyzés */ c_code(); /* második megjegyzés */ @@ -2090,27 +2090,28 @@ Ha azonban ez a tízes számrendszerbeli szám 10-nél kisebb, akkor mindig hivatkozásnak minõsül, s csak akkor okoz hibát, - ha nincs ennyi "gyûjtõ" részminta megnyitva az egész mintán - belül. Magyarán a 10-nél kisebb sorszámú kerek nyitó - zárójeleknek nem kell a hivatkozás elõtt, a mintában ettõl - balra állniuk. Olvasd el a "visszaperjel \" szakaszt, ahol - részletesen olvashatsz arról, hogy miképpen kezeli a PCRE a + ha nincs ennyi "gyûjtõ" részminta megnyitva az egész mintán + belül. Magyarán a 10-nél kisebb sorszámú kerek nyitó + zárójeleknek nem kell a hivatkozás elõtt, a mintában ettõl + balra állniuk. Olvasd el a "visszaperjel \" szakaszt, ahol + részletesen olvashatsz arról, hogy miképpen kezeli a PCRE a visszaperjel után álló számjegyeket. - A hivatkozások az általuk megcímzett "gyûjtõ" részmintákra + A hivatkozások az általuk megcímzett "gyûjtõ" részmintákra ténylegesen illeszkedõ szövegrészeket testesítik meg, és nem - azokat, amelyre illeszkedthetek volna egyébként. Mindjárt + azokat, amelyre illeszkedhettek volna egyébként. Mindjárt megvilágítjuk egy példán keresztül: (ért|kegy) és \1elem - illeszkedik a "kegy és kegyelem"-re és "ért és értelem"-re, + illeszkedik a "kegy és kegyelem"-re és "ért és értelem"-re, de nem illeszkedik az "ért és kegyelem"-re. - Ha a kis- és nagybetûk különbsége érvényben van a hivatkozás pillanatában, akkor számít a betûalakok különbsége. Például + Ha a kis- és nagybetûk különbsége érvényben van a hivatkozás + pillanatában, akkor számít a betûalakok különbsége. Például ((?i)rah)\s+\1 - minta illeszkedik a "rah rah" és "RAH RAH" szövegekre, de a + minta illeszkedik a "rah rah" és "RAH RAH" szövegekre, de a "RAH rah" -ra még akkor sem, ha az eredeti "gyûjtõ" részmintában a kis- és nagybetûk különbsége nem számított. @@ -2147,22 +2148,22 @@ használatával megoldható. </literallayout> </refsect2> - <refsect2 id="regexp.reference.assertions"> - <title>TESZTEK FELTÉTELEK</title> + <refsect2 id="regexp.reference.assertions"> + <title>TESZTEK - FELTÉTELEK</title> <literallayout> Angolul "assertion"-nek nevezett szerkezet olyan tesztet vagy feltételt jelent, ami a pillanatnyi illesztési pozició - elõtti vagy utáni karakterekre vonatkozik, de ténylegesen + elõtti vagy utáni karakterekre vonatkozik, de ténylegesen nem használ el karaktereket a tárgyszövegbõl az illesztés elõl, csak ellenõrzi egy feltétel fennállását. Az egyszerû - teszteket - \b, \B, \A, \Z, \z, ^ és $ - már tárgyaltuk. + teszteket - \b, \B, \A, \Z, \z, ^ és $ - már tárgyaltuk. Az ennél bonyolultabbakat részmintaként kell megadni.Kétféle - teszt van: az elõretekintõ, ami a pillanatnyi pozició utáni - karaktereket vizsgálja és a hátratekintõ, ami az az - elõttieket. - - A teszt részmintája a szokásos módon illeszkedik, attól - eltekintve, hogy a pillanatnyi illesztési poziciót nem + teszt van: az elõretekintõ, ami a pillanatnyi illesztési + pozició utáni karaktereket vizsgálja, és a hátratekintõ, ami + az az elõttieket. + + A teszt részmintája a szokásos módon illeszkedik, attól + eltekintve, hogy a pillanatnyi illesztési poziciót nem változtatja meg. Az elõretekintõ tesztek "(?=" vagy tagadó feltétel esetén "(?!" sorozattal kezdõdnek, például @@ -2179,9 +2180,9 @@ (?!ize)bigyo nem azokat a "bigyo"-kat találja meg, amelyek elõtt nem "ize" - van; hanem minden "bigyo"-t megtalál, mert a (?!ize) teszt + van; hanem minden "bigyo"-t megtalál, mert a (?!ize) teszt mindig igaz, hiszen az utána jövõ három karakter tényleg nem - "ize", hanem "bigy" (tesztként nem változik a pillanatnyi + "ize", hanem "bigy" (tesztként nem változik a pillanatnyi illesztési pozició - a fordító). Ahhoz, hogy a kívánt hatást érjük el a hátratekintõ tesztre van szükségünk. @@ -2190,10 +2191,10 @@ (?&lt;!ize)bigyo - azokat a "bigyo"-kat találja meg, amelyek elõtt nincs "ize". + azokat a "bigyo"-kat találja meg, amelyek elõtt nincs "ize". A hátratekintõ tesztek csak rögzített hosszúságúak lehetnek. - Ha azonban több alternatívát adunk meg a teszten belül, - a különbözõ ágaknak lehet eltérõ a hossza, ilyenformán + Ha azonban több alternatívát adunk meg a teszten belül, + a különbözõ ágaknak lehet eltérõ a hossza, ilyenformán a (?&lt;=tulok|szamár) @@ -2203,63 +2204,63 @@ mintával, amely kiértékelés / fordítás során hibát okoz. Az eltérõ hosszúságú ágtesztek a hátratekintõ tesztek - legfelsõ szintjén megengedettek. Ez PCRE bõvítés a Perl + legfelsõ szintjén megengedettek. Ez PCRE bõvítés a Perl 5.005-höz képest,ahol minden ágtesztnek azonos hosszúságúnak kell lennie. A (?&lt;=ab(c|de)) - mintához hasonló nem megengedett, mert a legfelsõ szinten + mintához hasonlók nem megengedettek, mert a legfelsõ szinten levõ egyetlen ág két különbözõ hosszúságú szövegre is illeszkedhet, de átírható, hogy a vagylagosságot a felsõ szintre emeljük: (?&lt;=abc|abde) - A hátratekintõ tesztek megvalósítása a következõ: minden - ágra a pillanatnyi illesztési pozició átmenetileg hátrébb + A hátratekintõ tesztek megvalósítása a következõ: minden + ágra a pillanatnyi illesztési pozició átmenetileg hátrébb kerül az ágtesztnek megfelelõ számú karakterrel és ezután illeszteni próbál. Ha nincs elég karakter a visszalépéshez, az illesztés sikertelen lesz. A hátratekintõ tesztek az - egyszeri részmintákkal együtt különösen hasznosak lehetnek + egyszeri részmintákkal együtt különösen hasznosak lehetnek a szöveg végi illeszkedéseknél, az "Egyszeri részminták" c. szakasz végén található erre példa. - + Számos különbözõ fajtájú teszt állhat egymás után, például: (?&lt;=\d{3})(?&lt;!999)ize - minta azokra az "ize"-kre illeszkedik, ami elõtt 3 számjegy - áll, amely nem a "999". Figyelj arra, hogy minden teszt - egymástól függetlenül, ugyanabban az illesztési pozicóban - kerül kiértékelésre. Elõször azt ellenõrzi, hogy a megelõzõ - három karakter számjegy-e és utána azt, hogy ezek nem a + minta azokra az "ize"-kre illeszkedik, ami elõtt 3 számjegy + áll, amely nem a "999". Figyelj arra, hogy minden teszt + egymástól függetlenül, ugyanabban az illesztési pozicóban + kerül kiértékelésre. Elõször azt ellenõrzi, hogy a megelõzõ + három karakter számjegy-e és utána azt, hogy ezek nem a "999"-t adják.Ez a minta nem azokra az "ize"-kre illeszkedik, - amelyek elõtt hat karakter áll: három számjegy és másik + amelyek elõtt hat karakter áll: három számjegy és másik három, ami nem a "999", példaképpen nem illeszkedik a "123abcize" szövegre. Az a minta, ami ezt tudja a következõ: (?&lt;=\d{3}...)(?&lt;!999)ize Ebben az esetben az elsõ teszt a megelõzõ hat karaktert nézi, - és azt vizsgálja, hogy az elsõ három számjegy-e, ezután a - második feltétel a maradék három karaktert nézi, hogy azok - nem a "999" sorozat. A tesztek egymásba ágyazhatók bármilyen + és azt vizsgálja, hogy az elsõ három számjegy-e, ezután a + második feltétel a maradék három karaktert nézi, hogy azok + nem a "999" sorozat. A tesztek egymásba ágyazhatók bármilyen komibinációban. Például a (?&lt;=(?&lt;!ize)bigyo)figyula - arra a "figyula"-ra illeszkedik, amit egy "bigyo" elõz meg, + arra a "figyula"-ra illeszkedik, amit egy "bigyo" elõz meg, ami elõtt nem áll "ize". Miközben (?&lt;=\d{3}(?!999)...)ize - egy másik minta az olyan "ize"-kre, amelyek elõtt három + egy másik minta az olyan "ize"-kre, amelyek elõtt három számjegy s ezután három olyan karakter áll, amely nem "999". A teszt-minták nem "gyûjtõ" részminták, és nem ismételhetõk, hiszen nincs sok értelme ugyanazt többször tesztelni. - Ha bármilyen teszt "gyûjtõ" részmintát tartalmaz, akkor + Ha bármilyen teszt "gyûjtõ" részmintát tartalmaz, akkor ezek a részminták is beleszámítanak a "gyûjtõ" részminták számozásába, azonban csak pozitív tesztekre lesz végrehajtva a megtalált szövegrész "begyûjtése", mert tagadó tesztek @@ -2272,29 +2273,29 @@ <refsect2 id="regexp.reference.onlyonce"> <title>Egyszeri részminták</title> <literallayout> - A mind a maximalizáló (mohó?) mind a minimalizáló (szerény?) - ismétlés esetén a következõ részek illesztésének a - sikertelensége általában az ismételt elem újbóli - kiértékelését eredményezi, hogy eltérõ számú ismétléssel - vajon a minta maradéka illeszkedik-e. Néhány esetben hasznos - ezt megelõzni akár a mintaillesztés viselkedésének - megváltoztatásával, vagy hagyni, hogy az illesztés hamarabb - elbukjon, mint egyébként, ha a minta készítõje (szóval te :) tudja, hogy nincs értelme folytatni. + A mind a maximalizáló (mohó) mind a minimalizáló (szerény) + ismétlés esetén a további részek sikertelen illesztése a + általában az ismételt elem újbóli kiértékelését eredményezi, + hogy eltérõ ismétlésszámmal a minta maradéka illeszkedik-e. + Néhány esetben hasznos ezt megelõzni akár a mintaillesztés + viselkedésének megváltoztatásával, vagy hagyni, hogy az + illesztés hamarabb elbukjon - mint egyébként -, ha a minta + készítõje tudja, hogy nincs értelme folytatni. Nézzük a következõ példát, ahol a \d+ize mintát a 123456bigyo szövegre illesztjük. - Miután 6 számjeggyel végzett,az illesztés elbukik az "ize"-n - . Ekkor a szokásos lépés, hogy megpróbálja újból 5 majd 4 és - - és így tovább - eggyel kevesebb számjegyet illeszteni a - "\d+"-re , amíg végül minden lehetõséget kimerítve az - illesztés elbukik. Az egyszeri részminták azt a lehetõséget + Miután 6 számjeggyel végzett,az illesztés elbukik az "ize"-n. + Ekkor a szokásos lépés, hogy megpróbálja újból 5 majd 4 és + - és így tovább sorjában - eggyel kevesebb számjegyet illeszteni + a "\d+"-re , amíg végül minden lehetõséget kimerítve + az illesztés elbukik. Az egyszeri részminták azt a lehetõséget biztosítják nekünk, hogy ha egyszer a minta egy darabja illeszkedett, akkor az ne legyen újra és újra kiértékelve a fenti módon, hanem az illesztés fejezõdjön be azonnal, ha az - "ize"-t nem tudja illeszteni mar az elso alkalommal. Ennek a + "ize"-t nem tudja illeszteni mar az elsõ alkalommal. Ennek a jelölésére egy speciális zárójelezés szolgál (?&gt;) (?&gt;\d+)bigyo @@ -2321,8 +2322,8 @@ Ez a szerkezet egymásba ágyazható, és természetesen tartalmazhat tetszõlegesen bonyolult részmintákat is. - Az egyszeri részminták a hátratekintõ tesztekkel közösen - hatékony szövegvégére illeszkedõ mintát képesek megadni. + Az egyszeri részminták a hátratekintõ tesztekkel közösen + hatékony a szöveg végére illeszkedõ mintát képesek megadni. Nézzük a következõ mintát abcd$ @@ -2367,7 +2368,7 @@ szövegre próbáljuk illeszteni, akkor sok idõt vesz igénybe, mire "értesülünk a kudarcról". Ez azért van, mert a szöveget - nagyon sokféleképpen lehet feldarabolni két ismétlés között + nagyon sokféleképpen lehet feldarabolni két ismétlés között és mindet végig kell próbálni. (A példában azért szerepelt [!?] a minta végén egy egyszerû karakter helyett, mert Perl és PCRE is rendelkezik egy beépített optimalizálással, amely @@ -2379,14 +2380,14 @@ ((?>\D+)|&lt;\d+>)*[!?] akkor a nem számjegyekbõl álló sorozatot nem lehet széttörni - és hamar kiderül, hogy nem az illesztés nem sikerült. + és hamar kiderül, hogy az illesztés nem sikerült. </literallayout> </refsect2> <refsect2 id="regexp.reference.conditional"> <title>Feltételes részminták</title> <literallayout> Lehetõség van arra, hogy egy teszt (assertion) eredményétõl - vagy egy elõzõ "gyûjtõ" részminta illeszkedésétõl függõen + vagy egy elõzõ "gyûjtõ" részminta illeszkedésétõl függõen más-más részmintával folytatódjon az illesztés. A feltételes részminták két alakja: @@ -2404,9 +2405,8 @@ hivatkozott "gyûjtõ" részminta elõzõleg már illeszkedett a szöveg valamely részére. Nézzük a következõ mintát, amelyben a térközök nem számítanak, csak az olvashatóságot és a - könnyebb tárgyalást szolgálják. - (feltételezzük, hogy a <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> be van - kapcsolva): + könnyebb tárgyalást szolgálják. (Feltételezzük, hogy a + <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> be van kapcsolva): ( \( )? [^()]+ (?(1) \) ) @@ -2433,19 +2433,19 @@ (?(?=[^a-z]*[a-z]) \d{2}-[a-z]{3}-\d{2} | \d{2}-\d{2}-\d{2} ) - (Elsõ sorban a tesztfeltétel, - a másodikban a két választható minta.) + (Az elsõ sorban a tesztfeltétel, + a másodikban a két választható minta.) A feltétel olyan elõretekintõ teszt, ami azt vizsgálja, hogy - egy betû elõtt elhagyható nem-betû karaktersorozat áll, azaz - legalább egy betû jelenlétét vizsgálja. Ha ez a betû jelen - van, akkor a tárgyszöveg az elsõ mintára illeszkedik, míg - egyébként a másodikra. Ez a minta vagy a "dd-aaa-dd" vagy a - "dd-dd-dd" alakú szövegekre illeszkedik, ahol "aaa" három - betût, "dd" pedig két számjegyet jelez. + egy betû elõtt elhagyható, nem betûkbõl álló karaktersorozat + áll, azaz legalább egy betû jelenlétét vizsgálja. Ha ez a + betû jelen van a szövegben, akkor a tárgyszöveg az elsõ + mintára illeszkedik, egyébként a másodikra. Ez a minta vagy a + "dd-aaa-dd" vagy a "dd-dd-dd" alakú szövegekre illeszkedik, + ahol "aaa" három betût, "dd" pedig két számjegyet jelez. </literallayout> </refsect2> - <refsect2 id="regexp.reference.comments"> - <title>Megjegyzések</title> + <refsect2 id="regexp.reference.comments"> + <title>Megjegyzések</title> <literallayout> A (?# karartersorozat megjegyzések kezdetét jelzi a mintán belül, amely a következõ bezáró kerek zárójelig tart. A @@ -2459,8 +2459,8 @@ karakterig tart. </literallayout> </refsect2> - <refsect2 id="regexp.reference.recursive"> - <title>Rekurzív (önhivatkozó) minták</title> + <refsect2 id="regexp.reference.recursive"> + <title>Rekurzív (önhivatkozó) minták</title> <literallayout> Nézzük az egymásba ágyazható zárójeles kifejezésekre @@ -2469,13 +2469,13 @@ ágyazhatóságot kezelõ mintát használunk. Nem megoldható a tetszõleges mélységû egymásbaágyazhatóság. Perl 5.6 kísérleti jelleggel biztosítja a lehetõséget a - reguláris kifejezések rekurzív bejárására (több egyéb - mellett). A különleges (?R) elem jelenti a meghatározott - önhivatkozási pontot. + reguláris kifejezések rekurzív bejárására (több más mellett). + A különleges (?R) elem jelenti a meghatározott önhivatkozási + pontot. A PCRE minta, amely megoldja a zárójelezett szövegek - problémáját (feltéve, hogy a <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> - módosító be van kapcsolva, tehát a térközök nem részei a - mintának) a következõ: + problémáját (feltéve, hogy a <link linkend="pcre.pattern.modifiers">PCRE_EXTENDED</link> módosító be + van kapcsolva, tehát a térközök nem részei a mintának) a + következõ: \( ( (?>[^()]+) | (?R) )* \) @@ -2487,7 +2487,8 @@ Ez a sajátságos minta korlátlan számú, egymásba ágyazott ismétlést takar, ezért a zárójel nélküli szövegrészre illesztésnél az egyszeri részminta használata nagyon fontos, - kiváltképp ha nem illeszkedõ tárgyszövegre alkalmazzuk. Ha például a + kiváltképp ha nem illeszkedõ tárgyszövegre alkalmazzuk. Ha + például a (aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa() @@ -2510,11 +2511,12 @@ \( ( ( (?>[^()]+) | (?R) )* ) \) ^ ^ - ^ ^ + ^ ^ , akkor a "ab(cd)ef" szöveg lesz legkülsõ "gyûjtõ" zárójel értéke. Ha 15-nél több "gyûjtõ" zárójel van a mintában, akkor PCRE tartalék memóriát foglal le, hogy az adatokat itt - tárolja a rekurzió alatt (pcre_malloc-kal foglalja le, és a pcre_free-vel szabadítja fel azután.) Ha nem lehet több + tárolja a rekurzió alatt (pcre_malloc-kal foglalja le, és a + pcre_free-vel szabadítja fel azután.) Ha nem lehet több memóriához hozzájutni, akkor csak az elsõ 15 "gyûjtõ" zárójelnek menti el az adatait, minthogy lehetetlen "nincs elég memória" hibaüzenetet kiadni a rekurzión belül. @@ -2525,10 +2527,11 @@ <literallayout> Bizonyos minták sokkal hatékonyabbak, mint mások, például [aáeéiíoóöõuúüû] karakterosztály hatékonyabb, mint ugyanezt - választható mintákkal (a|á|e|é|i|í|o|ó|ö|õ|u|ú|ü|û) megoldani. Általában a legegyszerûbb szerkezet, amely a - kívánt viselkedést biztosítja rendszerint a leghatékonyabb. - Jeffrey Friedl könyve rengeteg példát tartalmaz, hogyan kell - reguláris kifejezéseket optimalizálni a hatékony végrehajtáshoz. + választható mintákkal (a|á|e|é|i|í|o|ó|ö|õ|u|ú|ü|û) megoldani. + Általában a legegyszerûbb szerkezet, amely a kívánt viselkedést + biztosítja rendszerint a leghatékonyabb. Jeffrey Friedl könyve + rengeteg példát tartalmaz, hogyan kell reguláris kifejezéseket + optimalizálni a hatékony végrehajtáshoz. Ha a minta .* -gal kezdõdik, és a <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> módosító be van kapcsolva, akkor PCRE a mintát hallagtólagosan @@ -2547,15 +2550,15 @@ Ha az ilyesfajta mintákat olyan szövegekre alkalmazod, amelyekben nincsenek sortörések (újsorkarakterek), akkor a - legjobb teljesítmény a - <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> - módosító beállításával - vagy a "rögzítés" egyértelmû megadásával lehetséges: ^.* . Ez megkíméli PCRE-t, hogy végignézze a tárgyszöveget + legjobb teljesítmény a <link linkend="pcre.pattern.modifiers">PCRE_DOTALL</link> módosító beállításával + vagy a "rögzítés" egyértelmû megadásával lehetséges: ^.*. + Ez megkíméli a PCRE-t, hogy végignézze a tárgyszöveget újsorkaraktert keresve, ahonnan az illesztést újrakezdheti. Vigyázz azokkal a mintákkal, amelyek egymásba ágyazott határozatlan számú ismétlést tartalmaznak. Ezek a minták sok - idõt vesznek el, ha nem illeszkedõ szövegre kell alkalmazni õket. Nézzük a + idõt vesznek el, ha nem illeszkedõ szövegre kell alkalmazni + õket. Nézzük a (a+)* Index: phpdoc/hu/functions/bc.xml diff -u phpdoc/hu/functions/bc.xml:1.7 phpdoc/hu/functions/bc.xml:1.8 --- phpdoc/hu/functions/bc.xml:1.7 Sat Dec 15 09:47:01 2001 +++ phpdoc/hu/functions/bc.xml Fri Dec 21 11:54:40 2001 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.11 Maintainer: goba Status: ready --> -<!-- CREDITS: zvaranka --> +<!-- EN-Revision: 1.18 Maintainer: goba Status: ready --> +<!-- CREDITS: zvaranka,pgerzson --> <reference id="ref.bc"> <title>BCMath tetszõleges pontosságú matematikai függvények</title> @@ -8,9 +8,12 @@ <partintro> <para> - Ezek a függvények csak akkor érhetõek el ha a PHP-t a - <option role="configure">--enable-bcmath</option> paraméterrel - fordítottad. + PHP 4-ben ezek a függvények csak akkor érhetõek el, ha a PHP-t a + <link linkend="install.configure.enable-bcmath"><option role="configure">--enable-bcmath</option></link> + beállítással lett fordítva. + PHP 3-ban ezek a függvények csak akkor érhetõek el, ha a PHP-t NEM a + <link linkend="install.configure.enable-bcmath"><option role="configure">--disable-bcmath</option></link> + beállítással lett fordítva. </para> <note> <para> @@ -43,12 +46,12 @@ </funcsynopsis> <para> Hozzáadja a <parameter>left operand</parameter>-ot a - <parameter>right operand</parameter>-hoz és visszatér az összeget - tartalmazó stringgel. Az opcionális <parameter>scale</parameter> paraméter - beállítja az eredményben a tizedes pont utáni számjegyek számát. + <parameter>right operand</parameter>-hoz, és visszatér az összeget + tartalmazó stringgel. Az elhagyható <parameter>scale</parameter> paraméter + határozza meg az eredményben a tizedes pont utáni számjegyek számát. </para> <para> - Lásd még a <function>bcsub</function> függvényt. + Lásd még: <function>bcsub</function>! </para> </refsect1> </refentry> @@ -72,14 +75,13 @@ </funcsynopsis> <para> Összehasonlítja a <parameter>left operand</parameter>-ot a - <parameter>right operand</parameter>-al és az eredményt egészként + <parameter>right operand</parameter>-al, és az eredményt egészként visszaadja. Az elhagyható <parameter>scale</parameter> paraméter beállítja a tizedes pont utáni számjegyek számát, amely felhasználásra kerül az összehasonlításban. A visszatérési érték 0, ha a két operandus egyenlõ. Ha a <parameter>left operand</parameter> - nagyobb, mint a <parameter>right operand</parameter>, az eredmény - +1, de ha a <parameter>left operand</parameter> kisebb, mint - a <parameter>right operand</parameter> az eredmény -1. + nagyobb a <parameter>right operand</parameter>-nál, az eredmény + +1, de ha a <parameter>left operand</parameter> kisebb nála, az eredmény -1. </para> </refsect1> </refentry> @@ -103,12 +105,12 @@ </funcsynopsis> <para> Elosztja a <parameter>left operand</parameter>-ot a - <parameter>right operand</parameter>-al és visszaadja az eredményt. - Az opcionális <parameter>scale</parameter> paraméter beállítja + <parameter>right operand</parameter>-al, és visszaadja az eredményt. + Az elhagyható <parameter>scale</parameter> paraméter beállítja az eredményben a tizedespont utáni számjegyek számát. </para> <para> - Lásd még a <function>bcmul</function> függvényt. + Lásd még: <function>bcmul</function>! </para> </refsect1> </refentry> @@ -130,11 +132,11 @@ </funcprototype> </funcsynopsis> <para> - Kiszámítja a <parameter>left operand</parameter> modulusát, felhasználva - a <parameter>modulus</parameter> paramétert. + Kiszámítja a <parameter>left operand</parameter>-nak a + <parameter>modulus</parameter>-sal történõ osztás utáni maradékát. </para> <para> - Lásd még a <function>bcdiv</function> függcényt. + Lásd még: <function>bcdiv</function>! </para> </refsect1> </refentry> @@ -158,12 +160,12 @@ </funcsynopsis> <para> Összeszorozza a <parameter>left operand</parameter>-ot a - <parameter>right operand</parameter>-al és visszaadja az eredményt. Az - opcionális <parameter>scale</parameter> paraméter beállítja az + <parameter>right operand</parameter>-dal, és visszaadja az eredményt. Az + elhagyható <parameter>scale</parameter> paraméter határozza meg az eredményben a tizedespont utáni számjegyek számát. </para> <para> - Lásd még a <function>bcdiv</function> függvényt. + Lásd még: <function>bcdiv</function>! </para> </refsect1> </refentry> @@ -189,12 +191,12 @@ </funcsynopsis> <para> Kiszámítja <parameter>x</parameter> szám - <parameter>y</parameter>-adik hatványát. Az opcionális + <parameter>y</parameter>. hatványát. Az elhagyható <parameter>scale</parameter> paraméter beállítja az eredményben a tizedes pont utáni számjegyek számát. </para> <para> - Lásd még a <function>bcsqrt</function> függvényt. + Lásd még: <function>bcsqrt</function>! </para> </refsect1> </refentry> @@ -242,11 +244,11 @@ </funcsynopsis> <para> Visszaadja az <parameter>operand</parameter> négyzetgyökét. - Az opcionális <parameter>scale</parameter> paraméter beállítja + Az elhagyható <parameter>scale</parameter> paraméter beállítja az eredményben a tizedes pont utáni számjegyek számát. </para> <para> - Lásd még a <function>bcpow</function> függvényt. + Lásd még: <function>bcpow</function>! </para> </refsect1> </refentry> @@ -273,11 +275,11 @@ <para> Kivonja a <parameter>right operand</parameter>-ot a <parameter>left operand</parameter>-ból, és visszaadja az eredményt - tartalmazó string-et. Az opcionális <parameter>scale</parameter> + tartalmazó string-et. Az elhagyható <parameter>scale</parameter> paraméter beállítja az eredményben a tizedes pont utáni számjegyek számát. </para> <para> - Lásd még a <function>bcadd</function> függvényt. + Lásd még: <function>bcadd</function>! </para> </refsect1> </refentry> @@ -300,4 +302,7 @@ 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 -->