cvs: phpdoc /cs/functions array.xml

From: Date: Mon, 05 Feb 2001 12:40:02 +0000
Subject: cvs: phpdoc /cs/functions array.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969334167@lists.php.net to get a copy of this message
cynic Mon Feb 5 04:40:02 2001 EDT Added files: /phpdoc/cs/functions array.xml Log: should be completely translated

Index: phpdoc/cs/functions/array.xml +++ phpdoc/cs/functions/array.xml <reference id="ref.array"> <title>Funkce pro práci s poli</title> <titleabbrev>Pole</titleabbrev> <partintro> <simpara> Tyto funkce vám umo¾òují manipulovat a interagovat rùznými zpùsoby s poli. Pole jsou nezbytná pro ukládání a práci se sadami promìnných. </simpara> <simpara> Podporována jsou jednoduchá a vícerozmìrná pole; vytváøet se dají u¾ivatelsky i jako výstup funkce. Existují databázové funkce na plnìní polí výsledky databázových dotazù, a nìkolik dal¹ích funkcí vrací pole. </simpara> <para> Viz také: <function>is_array</function>, <function>explode</function>, <function>implode</function>, <function>split</function> a <function>join</function>. </para> </partintro> <refentry id="function.array"> <refnamediv> <refname>array</refname> <refpurpose> Vytvoøit pole </refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array</function></funcdef> <paramdef>mixed <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Vrací pole argumentù. Argumentùm mù¾e být pøiøazen index pomocí operátoru <literal>=&gt;</literal>. </para> <para> <note> <para> <function>array</function> je jazykový konstrukt pou¾ívaný k reprezentaci polí, nikoliv bì¾ná funkce. </para> </note> </para> <para> Syntaxe "index =&gt; hodnota", s èárko jako oddìlovaèem, definuje indexy a hodnoty. Index mù¾e být øetìzec nebo èíslo. Pokud se index vynechá, automaticky se generuje èíselný index zaèínající na 0. Pokud je index integer, dal¹í generovaný index bude nejvy¹¹í celoèíselný index + 1. Pozn.: pokud jsou definovány dva identické indexy, první se pøepí¹e posledním. </para> <para> Následující ukázka demonstruje jak vytvoøit dvourozmìrné pole, jak urèit klíèe v asociativních polích, a jak pøeskakovat èíselné indexy v normálních polích. <example> <title>Ukázka <function>array</function></title> <programlisting role="php"> $fruits = array ( "fruits" =&gt; array ("a"=&gt;"orange", "b"=&gt;"banana", "c"=&gt;"apple"), "numbers" =&gt; array (1, 2, 3, 4, 5, 6), "holes" =&gt; array ("first", 5 =&gt; "second", "third") ); </programlisting> </example> </para> <para> <example> <title>Automatický index a <function>array</function></title> <programlisting role="php"> $array = array( 1, 1, 1, 1, 1, 8=>1, 4=>1, 19, 3=>13); print_r($array); </programlisting> </example> výstup bude následující: <informalexample> <programlisting> Array ( [0] => 1 [1] => 1 [2] => 1 [3] => 13 [4] => 1 [8] => 1 [9] => 19 ) </programlisting> </informalexample> Index 3 je definován dvakrát, a podr¾í si poslední hodnotu 13. Index 4 je definován po indexu 8 a dal¹í generovaný index (hodnota 19) je 9, proto¾e nejvy¹¹í index byl 8. </para> <para> Tato ukázka vytvoøí pole èíslované od 1. <example> <title>Index zaèínající 1 s <function>array</function></title> <programlisting role="php"> $firstquarter = array(1 => 'January', 'February', 'March'); print_r($firstquarter); </programlisting> </example> toto bude výstup: <informalexample> <programlisting> Array ( [1] => 'January' [2] => 'February' [3] => 'March' ) </programlisting> </informalexample> </para> <para> Viz také: <function>list</function>. </para> </refsect1> </refentry> <refentry id="function.array-count-values"> <refnamediv> <refname>array_count_values</refname> <refpurpose>Spoèítat v¹echny hodnoty v poli</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array_count_values</function></funcdef> <paramdef>array <parameter>input</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>array_count_values</function> vrací pole pou¾ívající hodnoty z <parameter>input</parameter> jako klíèe a jejich èetnosti v <parameter>input</parameter> jako hodnoty. </para> <para> <example> <title>Ukázka <function>array_count_values</function></title> <programlisting role="php"> $array = array (1, "hello", 1, "world", "hello"); array_count_values ($array); // vrací array(1=&gt;2, "hello"=&gt;2, "world"=&gt;1) </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.array-diff"> <refnamediv> <refname>array_diff</refname> <refpurpose>Spoèítat rozdíl polí</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array_diff</function></funcdef> <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> <paramdef>array <parameter><optional> ...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>array_diff</function> vrací pole obsahující v¹echny hodnoty z <parameter>array1</parameter>, které se nevyskytují v ¾ádném z dal¹ích argumentù. Klíèe jsou zachovány. </para> <para> <example> <title>Ukázka <function>array_diff</function></title> <programlisting role="php"> $array1 = array ("a" =&gt; "green", "red", "blue"); $array2 = array ("b" =&gt; "green", "yellow", "red"); $result = array_diff ($array1, $array2); </programlisting> </example> </para> <para> <varname>$result</varname> obsahuje <literal>array ("blue");</literal> </para> <para> Viz také: <function>array_intersect</function>. </para> </refsect1> </refentry> <refentry id="function.array-flip"> <refnamediv> <refname>array_flip</refname> <refpurpose>Prohodit klíèe a hodnoty pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array_flip</function></funcdef> <paramdef>array <parameter>trans</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>array_flip</function> pole s prohozenými klíèi a hodnotami. </para> <para> <example> <title>Ukázka <function>array_flip</function></title> <programlisting role="php"> $trans = array_flip ($trans); $original = strtr ($str, $trans); </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.array-intersect"> <refnamediv> <refname>array_intersect</refname> <refpurpose>Spoèítat prùnik polí</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array_intersect</function></funcdef> <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> <paramdef>array <parameter><optional> ...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>array_intersect</function> vrací pole obsahující v¹echny hodnoty z <parameter>array1</parameter>, které se vyskytují ve v¹ech argumentech. Klíèe jsou zachovány. </para> <para> <example> <title>Ukázka <function>array_intersect</function></title> <programlisting role="php"> $array1 = array ("a" =&gt; "green", "red", "blue"); $array2 = array ("b" =&gt; "green", "yellow", "red"); $result = array_intersect ($array1, $array2); </programlisting> </example> </para> <para> <varname>$result</varname> obsahuje <literal>array ("a" =&gt; "green", "red");</literal> </para> <para> Viz také: <function>array_diff</function>. </para> </refsect1> </refentry> <refentry id="function.array-keys"> <refnamediv> <refname>array_keys</refname> <refpurpose>Vrátit v¹echny klíèe pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array_keys</function></funcdef> <paramdef>array <parameter>input</parameter></paramdef> <paramdef>mixed <parameter> <optional>search_value</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>array_keys</function> vrací klíèe, numerické i textové, z pole <parameter>input</parameter>. </para> <para> Pokud je pøítomen volitelný argument <parameter>search_value</parameter>, vrací pouze klíèe této hodnoty. Jinak vrací v¹echny klíèe z pole <parameter>input</parameter>. </para> <para> <example> <title>Ukázka <function>array_keys</function></title> <programlisting role="php"> $array = array (0 =&gt; 100, "color" =&gt; "red"); array_keys ($array); // vrací array (0, "color") $array = array ("blue", "red", "green", "blue", "blue"); array_keys ($array, "blue"); // vrací array (0, 3, 4) $array = array ("color" =&gt; array("blue", "red", "green"), "size" =&gt; array("small", "medium", "large")); array_keys ($array); // vrací array ("color", "size") </programlisting> </example> </para> <note> <para> Tato funkce byla pøidána v PHP 4, dále je uvedena implementace pro ty, kteøí stále pou¾ívají PHP 3. <example> <title> Implementace <function>array_keys</function> pro u¾ivatele PHP 3 </title> <programlisting role="php"> function array_keys ($arr, $term="") { $t = array(); while (list($k,$v) = each($arr)) { if ($term &amp;&amp; $v != $term) continue; $t[] = $k; } return $t; } </programlisting> </example> </para> </note> <para> Viz také: <function>array_values</function>. </para> </refsect1> </refentry> <refentry id="function.array-merge"> <refnamediv> <refname>array_merge</refname> <refpurpose>Slouèit dvì nebo více polí</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array_merge</function></funcdef> <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> <paramdef>array <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>array_merge</function> slouèí prvky dvou nebo více polí dohromady tak, ¾e hodnoty ka¾dého pole se pøipojí na konec pøedchozího. Vrací výsledné pole. </para> <para> Pokud mají vstupní pole stejný textový klíè, pozdìj¹í hodnota pøepí¹e døívìj¹í hodnotu. Pokud ale mají stejný èíselný klíè, pozdìj¹í hodnota tu púvodní nepøepí¹e, ale pøipojí se k ní. </para> <para> <example> <title>Ukázka <function>array_merge</function></title> <programlisting role="php"> $array1 = array ("color" =&gt; "red", 2, 4); $array2 = array ("a", "b", "color" =&gt; "green", "shape" =&gt; "trapezoid", 4); array_merge ($array1, $array2); </programlisting> </example> </para> <para> Výsledné pole bude <literal>array("color" =&gt; "green", 2, 4, "a", "b", "shape" =&gt; "trapezoid", 4)</literal>. </para> <para> Viz také: <function>array_merge_recursive</function>. </para> </refsect1> </refentry> <refentry id="function.array-merge-recursive"> <refnamediv> <refname>array_merge_recursive</refname> <refpurpose>Rekurzivnì slouèit dvì nebo více polí</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array_merge_recursive</function></funcdef> <paramdef>array <parameter>array1</parameter></paramdef> <paramdef>array <parameter>array2</parameter></paramdef> <paramdef>array <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>array_merge_recursive</function> slouèí prvky dvou nebo více polí tak, ¾e hodnoty pole se pøipojí na konec pøedchozího pole. Vrací výsledné pole. </para> <para> Pokud obsahují vstupní pole stejný textový klíè, hodnoty tìchto klíèù se rekurzivnì slouèí do pole tak, ¾e pokud je jedna z hodnot sama pole, tato funkce ji také slouèí s odpovídající polo¾kou z dal¹ího pole. Pokud ale tato pole mají stejný èíselný klíè, pozdìj¹í hodnota nepøepí¹e tu døívìj¹í, ale pøipojí se. </para> <para> <example> <title>Ukázka <function>array_merge_recursive</function></title> <programlisting role="php"> $ar1 = array ("color" =&gt; array ("favorite" =&gt; "red"), 5); $ar2 = array (10, "color" =&gt; array ("favorite" =&gt; "green", "blue")); $result = array_merge_recursive ($ar1, $ar2); </programlisting> </example> </para> <para> Výsledné pole bude <literal>array ("color" =&gt; array ("favorite" =&gt; array ("red", "green"), "blue"), 5, 10)</literal>. </para> <para> Viz také: <function>array_merge</function>. </para> </refsect1> </refentry> <refentry id="function.array-multisort"> <refnamediv> <refname>array_multisort</refname> <refpurpose>Tøídit více polí, nebo vícerozmìrné pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>array_multisort</function></funcdef> <paramdef>array <parameter>ar1</parameter></paramdef> <paramdef>mixed <parameter><optional>arg</optional></parameter> </paramdef> <paramdef>mixed <parameter><optional>...</optional></parameter> </paramdef> <paramdef>array <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>array_multisort</function> se dá vyu¾ít k tøídìní nìkolika polí najednou nebo k tøídìní vícerozmìrného pole XXX according by one of more dimensions. Pøi tøídìní udr¾uje asociace klíèù. </para> <para> Vstupní pole jsou manipulována jako sloupce tabulky, která se má tøídit podle øádkù - pøipomíná to funkcionalitu SQL klauzule ORDER BY. První pole je to, podle kterého se bude tøídit. Øádky (hodnoty) v tomto poli that compare the same are sorted by the next input array, and so on. </para> <para> Struktura argumentù této funkce je trochu neobvyklá, ale pru¾ná. První argument musí být pole. Ka¾dý dal¹í argument mù¾e být buï pole nebo jeden z pøíznak z následujících seznamù: </para> <para> Pøíznaky smìru tøídìní: <itemizedlist> <listitem> <simpara>SORT_ASC - tøídit vzestupnì</simpara> </listitem> <listitem> <simpara>SORT_DESC - tøídit sestupnì</simpara> </listitem> </itemizedlist> </para> <para> Pøíznaky typu tøídìní: <itemizedlist> <listitem> <simpara>SORT_REGULAR - porovnávat polo¾ky normálnì</simpara> </listitem> <listitem> <simpara>SORT_NUMERIC - porovnávat polo¾ky èíselnì</simpara> </listitem> <listitem> <simpara>SORT_STRING - porovnávat polo¾ky jako øetìzce</simpara> </listitem> </itemizedlist> </para> <para> Po ka¾dém poli mù¾ete specifikovat jeden pøíznak ka¾dého typu. Pøíznaky tøídìní specifikované po ka¾dém poli platí pouze pro toto pole - pro dal¹í pole se resetují na defaultní SORT_ASC a SORT_REGULAR. </para> <para> Pøi úspìchu vrací <literal>true</literal>, pøi selhání <literal>false</literal>. </para> <para> <example> <title>Tøídìní více polí</title> <programlisting role="php"> $ar1 = array ("10", 100, 100, "a"); $ar2 = array (1, 3, "2", 1); array_multisort ($ar1, $ar2); </programlisting> </example> </para> <para> V této ukázce bude po setøídìní první pole obsahovat 10, "a", 100, 100. Druhé pole bude obsahovat 1, 1, 2, "3". Polo¾ky druhého pole odpovídající identickým polo¾kám v prvním poli (100 a 100) byly také setøídìny. </para> <para> <example> <title>Tøídìní vícerozmìrného pole</title> <programlisting role="php"> $ar = array (array ("10", 100, 100, "a"), array (1, 3, "2", 1)); array_multisort ($ar[0], SORT_ASC, SORT_STRING, $ar[1], SORT_NUMERIC, SORT_DESC); </programlisting> </example> </para> <para> V této ukázce bude po setøídìní první pole obsahovat 10, 100, 100, "a" (bylo tøídìno vzestupnì jako øetìzce) a druhé pole bude obsahovat 1, 3, "2", 1 (tøídìno jako èísla, sestupnì). </para> </refsect1> </refentry> <refentry id="function.array-pad"> <refnamediv> <refname>array_pad</refname> <refpurpose>Doplnit pole hodnotou na urèenou délku</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array_pad</function></funcdef> <paramdef>array <parameter>input</parameter></paramdef> <paramdef>int <parameter>pad_size</parameter></paramdef> <paramdef>mixed <parameter>pad_value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>array_pad</function> vrací kopii pole <parameter>input</parameter> doplnìnou na velikost <parameter>pad_size</parameter> hodnotou <parameter>pad_value</parameter>. Pokud je <parameter>pad_size</parameter> kladná, pole je doplnìno zprava, pokud je negativní, zleva. Pokud je absolutní hodnota <parameter>pad_size</parameter> men¹í nebo rovna velikosti <parameter>input</parameter>, k doplnìní nedojde. </para> <para> <example> <title>Ukázka <function>array_pad</function></title> <programlisting role="php"> $input = array (12, 10, 9); $result = array_pad ($input, 5, 0); // výsledek je array (12, 10, 9, 0, 0) $result = array_pad ($input, -7, -1); // výsledek je array (-1, -1, -1, -1, 12, 10, 9) $result = array_pad ($input, 2, "noop"); // nedoplnìno </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.array-pop"> <refnamediv> <refname>array_pop</refname> <refpurpose>Odstranit prvek z konce pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>array_pop</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>array_pop</function> odstraní a vrátí poslední hodnotu pole <parameter>array</parameter>, èím¾ ho zkrátí o jeden prvek. </para> <para> <example> <title>Ukázka <function>Array_pop</function></title> <programlisting role="php"> $stack = array ("orange", "apple", "raspberry"); $fruit = array_pop ($stack); </programlisting> </example> </para> <para> <varname>$stack</varname> má teï pouze dva prvky: "orange" a "apple", a <varname>$fruit</varname> obsahuje "raspberry". </para> <para> Viz také: <function>array_push</function>, <function>array_shift</function> a <function>array_unshift</function>. </para> </refsect1> </refentry> <refentry id="function.array-push"> <refnamediv> <refname>array_push</refname> <refpurpose>Pøidat jeden nebo více prvkù na konec pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>array_push</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>mixed <parameter>var</parameter></paramdef> <paramdef>mixed <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>array_push</function> pøipojuje pøedané promìnné na konec <parameter>array</parameter>. Délka <parameter>array</parameter> se zvìt¹uje o poèet pøidaných promìnných. Úèinek je stejný jako: <programlisting role="php"> $array[] = $var; </programlisting> opakované pro ka¾dou <parameter>var</parameter>. </para> <para> Vrací nový poèet prvkù v poli. </para> <para> <example> <title>Ukázka <function>array_push</function></title> <programlisting role="php"> $stack = array (1, 2); array_push ($stack, "+", 3); </programlisting> </example> </para> <para> Výsledkem této ukázky by byl <varname>$stack</varname> obsahující 4 prvky: 1, 2, "+" a 3. </para> <para> Viz také: <function>array_pop</function>, <function>array_shift</function> a <function>array_unshift</function>. </para> </refsect1> </refentry> <refentry id="function.array-rand"> <refnamediv> <refname>array_rand</refname> <refpurpose>Vybrat náhodnì jeden nebo více prvkù pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>array_rand</function></funcdef> <paramdef>array <parameter>input</parameter></paramdef> <paramdef>int <parameter><optional>num_req</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>array_rand</function> je pomìrnì u¾iteèná, kdy¾ chcete z pole vybrat náhodnì jednu nebo více hodnot. Pøijímá pole <parameter>input</parameter> a volitelný argument <parameter>num_req</parameter>, který urèuje, kolik polo¾ek chcete. Jeho defaultní hodnota je 1. </para> <para> Pokud vybíráte pouze jednu polo¾ku, <function>array_rand</function> vrací klíè náhodné polo¾ky. Jinak vrací pole klíèù náhodnì vybraných polo¾ek. Takto mù¾ete vybírat náhodnì hodnoty i klíèe. </para> <para> Nezapomeòte inicializovat generátor náhodných èísel pomocí <function>srand</function>. </para> <para> <example> <title>Ukázka <function>array_rand</function></title> <programlisting role="php"> srand ((double) microtime() * 10000000); $input = array ("Neo", "Morpheus", "Trinity", "Cypher", "Tank"); $rand_keys = array_rand ($input, 2); print $input[$rand_keys[0]]."\n"; print $input[$rand_keys[1]]."\n"; </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.array-reverse"> <refnamediv> <refname>array_reverse</refname> <refpurpose>Vrátit pole s prvky v opaèném poøadí</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array_reverse</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>bool <parameter><optional>preserve_keys</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>array_reverse</function> takes input <parameter>array</parameter> and returns a new array with the order of the elements reversed, preserving the keys if <parameter>preserve_keys</parameter> is true. </para> <para> <example> <title><function>Array_reverse</function> example</title> <programlisting role="php"> $input = array ("php", 4.0, array ("green", "red")); $result = array_reverse ($input); $result_keyed = array_reverse ($input, true); </programlisting> </example> </para> <para> <varname>$result</varname> teï obsahuje <literal>array (array ("green", "red"), 4.0, "php")</literal>. Ale <varname>$result2[0]</varname> je stále <literal>"php"</literal>. </para> <note> <para> Druhý argument byl pøidán v PHP 4.0.3. </para> </note> </refsect1> </refentry> <refentry id="function.array-shift"> <refnamediv> <refname>array_shift</refname> <refpurpose>Odstranit prvek ze zaèátku pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>array_shift</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>array_shift</function> vrací první polo¾ku <parameter>array</parameter> a odstraní ji, èím¾ zkrátí <parameter>array</parameter> o jeden prvek a ostatní posune dolù. </para> <para> <example> <title>Ukázka <function>array_shift</function></title> <programlisting role="php"> $args = array ("-v", "-f"); $opt = array_shift ($args); </programlisting> </example> </para> <para> <varname>$args</varname> teï má jeden prvek: "-f" a <varname>$opt</varname> je "-v". </para> <para> Viz také: <function>array_unshift</function>, <function>array_push</function> a <function>array_pop</function>. </para> </refsect1> </refentry> <refentry id="function.array-slice"> <refnamediv> <refname>array_slice</refname> <refpurpose>Vytáhnout èást pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array_slice</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>int <parameter>offset</parameter></paramdef> <paramdef>int <parameter> <optional>length</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>array_slice</function> vrací sekvenci prvkù <parameter>array</parameter> urèených argumenty <parameter>offset</parameter> a <parameter>length</parameter>. </para> <para> Pokud je <parameter>offset</parameter> kladný, tato sekvence zaène <parameter>offset</parameter> polo¾ek od zaèátku <parameter>array</parameter>. Pokud je <parameter>offset</parameter> záporný, tato sekvence zaène tolik polo¾ek od konce <parameter>array</parameter>. </para> <para> Pokud je <parameter>length</parameter> kladná, tato sekvence bude obsahovat tolik prvkù. Pokud je <parameter>length</parameter> záporná, tato sekvence skonèí tolik prvkù od konce <parameter>array</parameter>. Pokud <parameter>length</parameter> vynecháte, tato sekvence bude obsahovat v¹echny prvky <parameter>array</parameter> od <parameter>offset</parameter> do konce. </para> <para> <example> <title>Ukázka <function>array_slice</function></title> <programlisting role="php"> $input = array ("a", "b", "c", "d", "e"); $output = array_slice ($input, 2); // returns "c", "d", and "e" $output = array_slice ($input, 2, -1); // returns "c", "d" $output = array_slice ($input, -2, 1); // returns "d" $output = array_slice ($input, 0, 3); // returns "a", "b", and "c" </programlisting> </example> </para> <para> Viz také: <function>array_splice</function>. </para> </refsect1> </refentry> <refentry id="function.array-splice"> <refnamediv> <refname>array_splice</refname> <refpurpose>Odstranit èást pole a nahradit ji nìèím jiným</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array_splice</function></funcdef> <paramdef>array <parameter>input</parameter></paramdef> <paramdef>int <parameter>offset</parameter></paramdef> <paramdef>int <parameter><optional>length</optional></parameter> </paramdef> <paramdef>array <parameter> <optional>replacement</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>array_splice</function> odstraòuje prvky pole <parameter>input</parameter> urèené argumenty <parameter>offset</parameter> a <parameter>length</parameter>, a pøípadnì je nahrazuje prvky volitelného argumentu (pole) <parameter>replacement</parameter>. </para> <para> Pokud je <parameter>offset</parameter> kladný, tato odstranìná èást zaène <parameter>offset</parameter> polo¾ek od zaèátku <parameter>array</parameter>. Pokud je <parameter>offset</parameter> záporný, zaène tolik polo¾ek od konce <parameter>array</parameter>. </para> <para> Pokud vynecháte <parameter>length</parameter>, <function>array_splice</function> odstraní v¹echno od <parameter>offset</parameter> do konce pole. Pokud je <parameter>length</parameter> kladná, odstraní se právì tolik prvkù. Pokud je <parameter>length</parameter> záporná, konec odstranìné èásti bude právì tolik prvkù od konce pole. Tip: k odstranìní v¹ech prvkù od <parameter>offset</parameter> do konce pole pøi souèasnì urèeném argumentu <parameter>replacement</parameter> pou¾ijte jako <parameter>length</parameter> <literal>count($input)</literal>. </para> <para> Pokud zadáte <parameter>replacement</parameter> pole, odstranìné prvky se nahradí prvky tohoto pole. Pokud argumenty <parameter>offset</parameter> a <parameter>length</parameter> definovány tak, ¾e se nic neodstraní, prvky pole <parameter>replacement</parameter> se vlo¾í na místo urèené argumentem <parameter>offset</parameter>. Tip: pokud je <parameter>replacement</parameter> jen jedna hodnota, není nutno ji umis»ovat do <literal>array()</literal>, leda¾e chcete, aby tato polo¾ka byla opravdu pole. </para> <para> Následující volání jsou ekvivalentní: <programlisting> array_push ($input, $x, $y) array_splice ($input, count ($input), 0, array ($x, $y)) array_pop ($input) array_splice ($input, -1) array_shift ($input) array_splice ($input, 0, 1) array_unshift ($input, $x, $y) array_splice ($input, 0, 0, array ($x, $y)) $a[$x] = $y array_splice ($input, $x, 1, $y) </programlisting> </para> <para> Vrací pole odstranìných prvkù. </para> <para> <example> <title>Ukázky <function>array_splice</function></title> <programlisting role="php"> $input = array ("red", "green", "blue", "yellow"); array_splice ($input, 2); // $input is now array ("red", "green") array_splice ($input, 1, -1); // $input is now array ("red", "yellow") array_splice ($input, 1, count($input), "orange"); // $input is now array ("red", "orange") array_splice ($input, -1, 1, array("black", "maroon")); // $input is now array ("red", "green", // "blue", "black", "maroon") </programlisting> </example> </para> <para> Viz také: <function>array_slice</function>. </para> </refsect1> </refentry> <refentry id="function.array-unique"> <refnamediv> <refname>array_unique</refname> <refpurpose>Odstranit z pole duplicitní hodnoty</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array_unique</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>array_unique</function> pøijímá pole <parameter>array</parameter> a vrací nové pole bez duplicitních hodnot. Klíèe jsou zachovány. </para> <para> <example> <title>Ukázka <function>array_unique</function></title> <programlisting role="php"> $input = array ("a" =&gt; "green", "red", "b" =&gt; "green", "blue", "red"); $result = array_unique ($input); </programlisting> </example> </para> <para> <varname>$result</varname> teï obsahuje <literal>array ("a" =&gt; "green", "red", "blue");</literal>. </para> </refsect1> </refentry> <refentry id="function.array-unshift"> <refnamediv> <refname>array_unshift</refname> <refpurpose>Pøipojit jeden nebo více prvkù na zaèátek pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>array_unshift</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>mixed <parameter>var</parameter></paramdef> <paramdef>mixed <parameter> <optional>...</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>array_unshift</function> pøipojí pøedané prvky na zaèátek <parameter>array</parameter>. V¹echny prvky jsou pøidány jako celek, èili pøidané prvky si zachovávají poøadí. </para> <para> vrací nový poèet prvkù v <parameter>array</parameter>. </para> <para> <example> <title>Ukázka <function>array_unshift</function></title> <programlisting role="php"> $queue = array ("p1", "p3"); array_unshift ($queue, "p4", "p5", "p6"); </programlisting> </example> </para> <para> <varname>$queue</varname> bude mít 5 prvkù: "p4", "p5", "p6", "p1" a "p3". </para> <para> Viz také: <function>array_shift</function>, <function>array_push</function> a <function>array_pop</function>. </para> </refsect1> </refentry> <refentry id="function.array-values"> <refnamediv> <refname>array_values</refname> <refpurpose>Vrátit v¹echny hodnoty v poli</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>array_values</function></funcdef> <paramdef>array <parameter>input</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>array_values</function> vrací v¹echny hodnoty pole <parameter>input</parameter>. </para> <para> <example> <title>Ukázka <function>array_values</function></title> <programlisting role="php"> $array = array ("size" =&gt; "XL", "color" =&gt; "gold"); array_values ($array); // vrátí array ("XL", "gold") </programlisting> </example> </para> <note> <para> Tato funkce byla pøidána v PHP 4, následuje implementace pro ty, kdo stále pou¾ívají PHP 3. <example> <title> Implementace <function>array_values</function> pro u¾ivatele PHP 3 </title> <programlisting role="php"> function array_values ($arr) { $t = array(); while (list($k, $v) = each ($arr)) { $t[] = $v; return $t; } } </programlisting> </example> </para> </note> </refsect1> </refentry> <refentry id="function.array-walk"> <refnamediv> <refname>array_walk</refname> <refpurpose>Pou¾ít u¾ivatelskou funkci na v¹echny prvky pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>array_walk</function></funcdef> <paramdef>array <parameter>arr</parameter></paramdef> <paramdef>string <parameter>func</parameter></paramdef> <paramdef>mixed <parameter>userdata</parameter></paramdef> </funcprototype> </funcsynopsis> <simpara> Aplikuje funkci <parameter>func</parameter> na v¹echny prvky pole <parameter>arr</parameter>. Funkci <parameter>func</parameter> se jako první argument pøedá hodnota a jako druhý klíè. Pokud je pøítomen argument <parameter>userdata</parameter>, bude u¾ivatelské funkci pøedán jako tøetí argument. </simpara> <simpara> Pokud <parameter>func</parameter> vy¾aduje více ne¾ dva nebo tøi argumenty (v závislosti na <parameter>userdata</parameter>), pro ka¾dé volání <parameter>func</parameter> z <function>array_walk</function> se vygeneruje varování. Tato varování se dají potlaèit pøidáním znaku '@' pøed volání <function>array_walk</function> nebo pomocí <function>error_reporting</function>. </simpara> <note> <para> Pokud <parameter>func</parameter> potøebuje pracovat pøímo s daným polem, první argument <parameter>func</parameter> se musí pøedávat odkazem. V¹echny zmìny tìchto hodnot se pak promítnou pøímo v <parameter>arr</parameter>. </para> </note> <note> <para> Druhý a tøetí argument <parameter>func</parameter> byly pøidány v PHP 4.0. </para> <para> V PHP 4 je tøeba volat podle potøeby <function>reset</function>, proto¾e <function>array_walk</function> sama vstupní pole neresetuje. </para> </note> <para> <example> <title>Ukázka <function>array_walk</function></title> <programlisting role="php"> $fruits = array ("d"=&gt;"lemon", "a"=&gt;"orange", "b"=&gt;"banana", "c"=&gt;"apple"); function test_alter (&amp;$item1, $key, $prefix) { $item1 = "$prefix: $item1"; } function test_print ($item2, $key) { echo "$key. $item2&lt;br&gt;\n"; } array_walk ($fruits, 'test_print'); reset ($fruits); array_walk ($fruits, 'test_alter', 'fruit'); reset ($fruits); array_walk ($fruits, 'test_print'); </programlisting> </example> </para> <simpara> Viz také: <function>each</function> a <function>list</function>. </simpara> </refsect1> </refentry> <refentry id="function.arsort"> <refnamediv> <refname>arsort</refname> <refpurpose>Tøídit pole sestupnì se zachováním klíèù </refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>arsort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>int <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>arsort</function> tøídí pole tak, ¾e indexy pole si zachovávají korelace s prvky, se kterými jsou asociovány. Toto je u¾iteèné hlavnì pøi tøídìní asociativních polí, kde je poøadí prvkù signifikantní. <example> <title>Ukázka <function>Arsort</function></title> <programlisting role="php"> $fruits = array ("d"=&gt;"lemon", "a"=&gt;"orange", "b"=&gt;"banana", "c"=&gt;"apple"); arsort ($fruits); reset ($fruits); while (list ($key, $val) = each ($fruits)) { echo "$key = $val\n"; } </programlisting> </example> </para> <para> Tato ukázka zobrazí: </para> <para> <informalexample> <programlisting> fruits[a] = orange fruits[d] = lemon fruits[b] = banana fruits[c] = apple </programlisting> </informalexample> </para> <para> Ovoce bylo sestupnì setøídìno podle abecedy, a indexy asociované s jednotlivými prvky byly zachovány. </para> <para> Chování tøídìní mù¾ete upravit pomocí volitelného argumentu <parameter>sort_flags</parameter>, detaily viz <function>sort</function>. </para> <para> Viz také: <function>asort</function>, <function>rsort</function>, <function>ksort</function> a <function>sort</function>. </para> </refsect1> </refentry> <refentry id="function.asort"> <refnamediv> <refname>asort</refname> <refpurpose>Tøídit pole se zachováním indexù</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>asort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>int <parameter><optional>sort_flags</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>asort</function> tøídí pole tak, ¾e si indexy zachovají corelace s prvky, se kterými jsou spojeny. To je u¾iteèné hlavnì pøi tøídìní asociativních polí, u kterých je poøadí prvkù signifikantní. <example> <title>Ukázka <function>Asort</function></title> <programlisting role="php"> $fruits = array ("d"=&gt;"lemon", "a"=&gt;"orange", "b"=&gt;"banana", "c"=&gt;"apple"); asort ($fruits); reset ($fruits); while (list ($key, $val) = each ($fruits)) { echo "$key = $val\n"; } </programlisting> </example> </para> <para> Tato ukázka zobrazí: </para> <para> <informalexample> <programlisting> fruits[c] = apple fruits[b] = banana fruits[d] = lemon fruits[a] = orange </programlisting> </informalexample> </para> <para> Ovoce bylo setøídìno podle abecedy a indexy spojené s jednotlivými prvky byly zachovány. </para> <para> Chování tøídìní mù¾ete upravit pomocí volitelného argumentu <parameter>sort_flags</parameter>, detaily viz <function>sort</function>. </para> <para> Viz také: <function>arsort</function>, <function>rsort</function>, <function>ksort</function> a <function>sort</function>. </para> </refsect1> </refentry> <refentry id="function.compact"> <refnamediv> <refname>compact</refname> <refpurpose>Vytvoøit pole obsahující promìnné a jejich hodnoty</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>compact</function></funcdef> <paramdef>mixed <parameter>varname</parameter></paramdef> <paramdef>mixed <parameter><optional>...</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>compact</function> pøijímá promìnný poèet argumentù. Ka¾dý argument mù¾e být buï øetìzec obsahující název promìnné nebo pole názvù promìnných. Toto pole mù¾e také obsahovat pole názvù promìnnýchù; <function>compact</function> je rekurzivnì zpracuje. </para> <para> Pro ka¾dý z øetìzcù <function>compact</function> vyhledá v aktivní symbolové tabulce promìnnou tohoto jména a pøidá ji do výsledného pole tak, ¾e název této promìnné se stane klíèem a obsah této promìnné hodnotou tohoto klíèe. Struènì øeèeno, dìlá pravý opak toho, co <function>extract</function>. Vrací pole obsahující v¹echny tyto promìnné. </para> <para> Øetìzce, které neobsahují názvy platných promìnných se pøeskoèí. </para> <para> <example> <title>Ukázka <function>compact</function></title> <programlisting role="php"> $city = "San Francisco"; $state = "CA"; $event = "SIGGRAPH"; $location_vars = array ("city", "state"); $result = compact ("event", "nothing_here", $location_vars); </programlisting> <para> <varname>$result</varname> bude <literal>array ("event" =&gt; "SIGGRAPH", "city" =&gt; "San Francisco", "state" =&gt; "CA")</literal>. </para> </example> </para> <para> Viz také: <function>extract</function>. </para> </refsect1> </refentry> <refentry id="function.count"> <refnamediv> <refname>count</refname> <refpurpose>Spoèítat prvky v promìnné</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>count</function></funcdef> <paramdef>mixed <parameter>var</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Vrací poèet prvkù v <parameter>var</parameter>, která je typicky pole (jeliko¾ v¹echno ostatní má jeden prvek). </para> <para> Vrací <literal>1</literal>, pokud <parameter>var</parameter> není pole. </para> <para> Vrací <literal>0</literal>, pokud <parameter>var</parameter> není inicializována. <warning> <para> <function>count</function> vrací <literal>0</literal> pro promìnné, které nejsou inicializovány, ale vrací také <literal>0</literal> pro promìnné, které obsahují prázdné pole. Pokud potøebujete zjistit, jestli dotyèná promìnná existuje, pou¾ijte <function>isset</function>. </para> </warning> </para> <para> <example> <title>Ukázka <function>count</function></title> <programlisting role="php"> $a[0] = 1; $a[1] = 3; $a[2] = 5; $result = count ($a); //$result == 3 </programlisting> </example> </para> <para> Viz také: <function>sizeof</function>, <function>isset</function> a <function>is_array</function>. </para> </refsect1> </refentry> <refentry id="function.current"> <refnamediv> <refname>current</refname> <refpurpose>Vrátit souèasný prvek pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>current</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Ka¾dé pole má vnitøní ukazatel na jeho "souèasny" prvek, který se inicializuje na první prvek vlo¾ený do tohoto pole. </para> <para> <function>current</function> vrací prvek, na který tento interní ukazatel právì ukazuje. Nijak tento ukazatel nemìní. Pokud teto vnitøní ukazatel ukazuje za konec seznamu prvkù, <function>current</function> returns <literal>false</literal>. <warning> <para> Pokud toto pole obsahuje prázdné prvky (0 nebo "", prázdný øetìzec), tato funkce pro tyto prvky také vrátí <literal>false</literal>. Je proto nemo¾né urèit pomocí <function>current</function>, jestli jste opravdu na konci pole. To properly traverse an array that may contain empty elements, use the <function>each</function> function. </para> </warning> </para> <para> Viz také: <function>end</function>, <function>next</function>, <function>prev</function> a <function>reset</function>. </para> </refsect1> </refentry> <refentry id="function.each"> <refnamediv> <refname>each</refname> <refpurpose> Vrací dal¹í klíè/hodnota pár z pole </refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>each</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Vrací souèasný klíè/hodnota pár z pole <parameter>array</parameter> a posune interní ukazatel pole. Tento pár se vrací jako pole ètyø prvkù s klíèi <emphasis>0</emphasis>, <emphasis>1</emphasis>, <emphasis>key</emphasis> a <emphasis>value</emphasis>. Prvky <emphasis>0</emphasis> a <emphasis>key</emphasis> obsahují název klíèe tohoto prvku pole a <emphasis>1</emphasis> a <emphasis>value</emphasis> obsahují hodnotu. </para> <para> Pokud interní ukazatel pole ukazuje za konec tohoto pole, <function>each</function> vrací <literal>false</literal>. </para> <para> <example> <title>Ukázky <function>each</function></title> <programlisting role="php"> $foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese"); $bar = each ($foo); </programlisting> <para> <varname>$bar</varname> teï obsahuje následující klíè/hodnota páry: <itemizedlist spacing="compact"> <listitem><simpara>0 =&gt; 0</simpara></listitem> <listitem><simpara>1 =&gt; 'bob'</simpara></listitem> <listitem><simpara>key =&gt; 0</simpara></listitem> <listitem><simpara>value =&gt; 'bob'</simpara></listitem> </itemizedlist> <programlisting role="php"> $foo = array ("Robert" =&gt; "Bob", "Seppo" =&gt; "Sepi"); $bar = each ($foo); </programlisting> </para> <para> <varname>$bar</varname> teï obsahuje následující klíè/hodnota páry: <itemizedlist spacing="compact"> <listitem><simpara>0 =&gt; 'Robert'</simpara></listitem> <listitem><simpara>1 =&gt; 'Bob'</simpara></listitem> <listitem><simpara>key =&gt; 'Robert'</simpara></listitem> <listitem><simpara>value =&gt; 'Bob'</simpara></listitem> </itemizedlist> </para> </example> </para> <para> <function>each</function> se vìt¹inou pou¾íva s <function>list</function> k prùchodu polem, napø. <varname>$HTTP_POST_VARS</varname>: <example> <title> Prùchod <varname>$HTTP_POST_VARS</varname> pomocí <function>each</function> </title> <programlisting role="php"> echo "Hodnoty odeslané metodou POST:&lt;br&gt;"; reset ($HTTP_POST_VARS); while (list ($key, $val) = each ($HTTP_POST_VARS)) { echo "$key =&gt; $val&lt;br&gt;"; } </programlisting> </example> </para> <para> Poté, co probìhne <function>each</function>, se interní ukazatel pole posune na dal¹í prvek pole nebo zùstane na posledním prvku pole, pokud dojde na konec. </para> <para> Viz také: <function>key</function>, <function>list</function>, <function>current</function>, <function>reset</function>, <function>next</function> a <function>prev</function>. </para> </refsect1> </refentry> <refentry id="function.end"> <refnamediv> <refname>end</refname> <refpurpose> Nastavit vnitøní ukazatel pole na jeho poslední prvek </refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>end</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>end</function> posune vnitøní ukazatel pole <parameter>array</parameter> na jeho poslední prvek a vrací tento prvek. </para> <para> Viz také: <function>current</function>, <function>each</function>, <function>end</function>, <function>next</function> a <function>reset</function>. </para> </refsect1> </refentry> <refentry id="function.extract"> <refnamediv> <refname>extract</refname> <refpurpose>Importovat promìnné z pole do symbolové tabulky</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>extract</function></funcdef> <paramdef>array <parameter>var_array</parameter></paramdef> <paramdef>int <parameter><optional>extract_type</optional></parameter> </paramdef> <paramdef>string <parameter><optional>prefix</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Tato funkce se pou¾ívá k importu promìnných z pole do aktivní symbolové tabulky. Pøijímá pole <parameter>var_array</parameter>; z klíèù vytváøí názvy promìnných a z hodnot hodnoty tìchto promìnných. Vytváøí jednu promìnnou z ka¾dého klíè/hodnota páru (s ohledem na argumenty <parameter>extract_type</parameter> a <parameter>prefix</parameter>). </para> <note> <para> Od PHP 4.0.5 tato funkce vrací poèet extrahovaných promìnných. </para> </note> <para> <function>extract</function> ovìøuje, jestli v¹echny klíèe tvoøí platné názvy promìnných, a také jestli nekolidují s promìnnými existujícími v aktivní symbolové tabulce. Zpùsob, jakým se nakládá s neplatnými/numerickými klíèi a kolizemi závisí na <parameter>extract_type</parameter>. Ten mù¾e mít jednu z následujících hodnot. <variablelist> <varlistentry> <term>EXTR_OVERWRITE</term> <listitem> <simpara> Pokud existuje kolize, pøepsat existující promìnnou. </simpara> </listitem> </varlistentry> <varlistentry> <term>EXTR_SKIP</term> <listitem> <simpara> Pokud existuje kolize, nepøepsat existující promìnnou. </simpara> </listitem> </varlistentry> <varlistentry> <term>EXTR_PREFIX_SAME</term> <listitem> <simpara> Pokud existuje kolize, pøedøadit pøed název nové promìnné <parameter>prefix</parameter>. </simpara> </listitem> </varlistentry> <varlistentry> <term>EXTR_PREFIX_ALL</term> <listitem> <simpara> Opatøit prefixem <parameter>prefix</parameter> v¹echny názvy promìnných. Od PHP 4.0.5 toto zahrnuje i èíselné indexy. </simpara> </listitem> </varlistentry> <varlistentry> <term>EXTR_PREFIX_INVALID</term> <listitem> <simpara> Prefixem <parameter>prefix</parameter> opatøit pouze neplatné/èíselné názvy promìnných. Tento pøíznak byl pøidán v PHP 4.0.5. </simpara> </listitem> </varlistentry> </variablelist> </para> <para> Defaultní <parameter>extract_type</parameter> je EXTR_OVERWRITE. </para> <para> Pozn.: <parameter>prefix</parameter> se vy¾aduje pouze pokud je <parameter>extract_type</parameter> EXTR_PREFIX_SAME, EXTR_PREFIX_ALL nebo EXTR_PREFIX_INVALID. Pokud výsledný název (vè. prefixu) není platný název promìnné, nenaimportuje se do symbolové tabulky. </para> <para> <function>extract</function> vrací poèet promìnných úspì¹nì naimportovaných do symbolové tabulky. </para> <para> Mo¾né vyu¾ití <function>extract</function> je import promìnných do symbolové tabulky z asociativního pole vráceného <function>wddx_deserialize</function>. </para> <para> <example> <title>Ukázka <function>Extract</function></title> <programlisting role="php"> &lt;?php /* Pøedpokládejme, ¾e $var_array je pole vrácené z wddx_deserialize */ $size = "large"; $var_array = array ("color" =&gt; "blue", "size" =&gt; "medium", "shape" =&gt; "sphere"); extract ($var_array, EXTR_PREFIX_SAME, "wddx"); print "$color, $size, $shape, $wddx_size\n"; ?> </programlisting> </example> </para> <para> Vý¹e uvedená ukázka vytiskne: <programlisting> blue, large, sphere, medium </programlisting> </para> <para> <varname>$size</varname> se nepøepsala, proto¾e bylo specifikováno EXTR_PREFIX_SAME, tudí¾ se vytvoøila promìnná <varname>$wddx_size</varname>. Pokud by bylo zadáno EXTR_SKIP, nevytvoøila by se ani <varname>$wddx_size</varname>. EXTR_OVERWRITE by zpùsobilo pøepsání hodnoty <varname>$size</varname> na "medium", a EXTR_PREFIX_ALL by vytvoøilo nové promìnné pojmenované <varname>$wddx_color</varname>, <varname>$wddx_size</varname> a <varname>$wddx_shape</varname>. </para> <para> U PHP verzí ni¾¹ích ne¾ 4.0.5 musíte pou¾ít asociativní pole. </para> <para> Viz také: <function>compact</function>. </para> </refsect1> </refentry> <refentry id="function.in-array"> <refnamediv> <refname>in_array</refname> <refpurpose>Vrátit <literal>true</literal>, pokud v poli existuje daná hodnota</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>bool in_array</funcdef> <paramdef>mixed <parameter>needle</parameter></paramdef> <paramdef>array <parameter>haystack</parameter></paramdef> <paramdef>bool <parameter>strict</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Hledá v <parameter>haystack</parameter> <parameter>needle</parameter> a pokud ji najde, vrací <literal>true</literal>, jinak <literal>false</literal>. </para> <para> Pokud je tøetí argument <parameter>strict</parameter> <literal>true</literal>, <function>in_array</function> také kontroluje typ <parameter>needle</parameter> v <parameter>haystack</parameter>. </para> <para> <example> <title>Ukázka <function>in_array</function></title> <programlisting role="php"> $os = array ("Mac", "NT", "Irix", "Linux"); if (in_array ("Irix", $os)){ print "Got Irix"; } </programlisting> </example> </para> <para> <example> <title>Ukázka <function>in_array</function> s argumentem <parameter>strict</parameter></title> <programlisting role="php"> <?php $a = array('1.10', 12.4, 1.13); if (in_array('12.4', $a, true)) echo &quot;'12.4' found with strict check\n&quot;; if (in_array(1.13, $a, true)) echo &quot;1.13 found with strict check\n&quot;; ?> // Výstup bude: 1.13 found with strict check </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.key"> <refnamediv> <refname>key</refname> <refpurpose>Fetch a key from an associative array</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>key</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>key</function> vrací index souèasného prvku pole. </para> <para> Viz také: <function>current</function> a <function>next</function>. </para> </refsect1> </refentry> <refentry id="function.krsort"> <refnamediv> <refname>krsort</refname> <refpurpose>Tøídit pole sestupnì podle klíèù</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>krsort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>int <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Tøídí pole sestupnì podle klíèù se zachování asociací indexù. To je u¾iteèné hlavnì pøi práci s asociativními poli. <example> <title><function>Krsort</function> example</title> <programlisting role="php"> $fruits = array ("d"=&gt;"lemon", "a"=&gt;"orange", "b"=&gt;"banana", "c"=&gt;"apple"); krsort ($fruits); reset ($fruits); while (list ($key, $val) = each ($fruits)) { echo "$key -&gt; $val\n"; } </programlisting> </example> </para> <para> Tato ukázka vytiskne: </para> <para> <informalexample> <programlisting> fruits[d] = lemon fruits[c] = apple fruits[b] = banana fruits[a] = orange </programlisting> </informalexample> </para> <para> Vlastnosti tøídìní lze upravit pomocí volitelného argumentu <parameter>sort_flags</parameter>, detaily viz <function>sort</function>. </para> <simpara> Viz také: <function>asort</function>, <function>arsort</function>, <function>ksort</function>, <function>sort</function>, <function>natsort</function> a <function>rsort</function>. </simpara> </refsect1> </refentry> <refentry id="function.ksort"> <refnamediv> <refname>ksort</refname> <refpurpose>Tøídit pole podle klíèù</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ksort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>int <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Tøídí pole podle klíèù se zachování asociací indexù. To je u¾iteèné hlavnì pøi práci s asociativními poli. <example> <title><function>Ksort</function> example</title> <programlisting role="php"> $fruits = array ("d"=&gt;"lemon", "a"=&gt;"orange", "b"=&gt;"banana", "c"=&gt;"apple"); ksort ($fruits); reset ($fruits); while (list ($key, $val) = each ($fruits)) { echo "$key -&gt; $val\n"; } </programlisting> </example> </para> <para> Tato ukázka vytiskne: </para> <para> <informalexample> <programlisting> fruits[a] = orange fruits[b] = banana fruits[c] = apple fruits[d] = lemon </programlisting> </informalexample> </para> <para> Vlastnosti tøídìní lze upravit pomocí volitelného argumentu <parameter>sort_flags</parameter>, detaily viz <function>sort</function>. </para> <simpara> Viz také: <function>asort</function>, <function>arsort</function>, <function>sort</function>, <function>natsort</function> a <function>rsort</function>. </simpara> <note> <para> Druhý argument byl pøidán v PHP 4. </para> </note> </refsect1> </refentry> <refentry id="function.list"> <refnamediv> <refname>list</refname> <refpurpose>Pøiøadit hodnoty pøomìnným jako kdyby byly polem</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>list</function></funcdef> <varargs/> </funcprototype> </funcsynopsis> <para> Stejnì jako <function>array</function>, <function>list</function> vlastnì není funkce, ale jazykový konstrukt. Pou¾ívá se k pøiøazení hodnot více promìnným v jedné operaci. <example> <title>Ukázka <function>list</function></title> <programlisting role="php"> &lt;table> &lt;tr> &lt;th>Employee name&lt;/th> &lt;th>Salary&lt;/th> &lt;/tr> &lt;?php $result = mysql ($conn, "SELECT id, name, salary FROM employees"); while (list ($id, $name, $salary) = mysql_fetch_row ($result)) { print (" &lt;tr>\n". " &lt;td>&lt;a href=\"info.php3?id=$id\">$name&lt;/a>&lt;/td>\n". " &lt;td>$salary&lt;/td>\n". " &lt;/tr>\n"); } ?> &lt;/table> </programlisting> </example> </para> <para> Viz také: <function>each</function> a <function>array</function>. </para> </refsect1> </refentry> <refentry id="function.natsort"> <refnamediv> <refname>natsort</refname> <refpurpose> Tøídit pole s vyu¾itím algoritmu "pøirozeného tøídìní" </refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>natsort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Tato funkce implementuje srovnávací algoritmus který tøídí alfanumerické øetìzce stejným zpùsobem jako èlovìk, toto se popisuje jako "pøirozené tøídìní". Ukázka rozdílu mìzi tímto algoritmem a bì¾nými poèítaèovými algoritmy pro øazení øetìzcù (napø. <function>sort</function>): </para> <para> <example> <title>Ukázka <function>natsort</function></title> <programlisting role="php"> $array1 = $array2 = array ("img12.png","img10.png","img2.png","img1.png"); sort($array1); echo "Standardní tøídìní\n"; print_r($array1); natsort($array2); echo "\nPøirozené tøídìní\n"; print_r($array2); </programlisting> </example> </para> <para> Vý¹e uvedený kód vygeneruje následující výstup: </para> <para> <informalexample> <programlisting> Standardní tøídìní Array ( [0] =&gt; img1.png [1] =&gt; img10.png [2] =&gt; img12.png [3] =&gt; img2.png ) Pøirozené tøídìní Array ( [3] =&gt; img1.png [2] =&gt; img2.png [1] =&gt; img10.png [0] =&gt; img12.png ) </programlisting> </informalexample> Více informací viz stránka Martina Poola <ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink>. </para> <para> Viz také: <function>natcasesort</function>, <function>strnatcmp</function> a <function>strnatcasecmp</function>. </para> </refsect1> </refentry> <refentry id="function.natcasesort"> <refnamediv> <refname>natcasesort</refname> <refpurpose> Tøídit pole s vyu¾itím algoritmu "pøirozeného tøídìní" (case-insensitive) </refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>natcasesort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Tato funkce implementuje srovnávací algoritmus který tøídí alfanumerické øetìzce stejným zpùsobem jako èlovìk, toto se popisuje jako "pøirozené tøídìní". </para> <para> <function>natcasesort</function> je case-insensitive verze <function>natsort</function>. Ukázka rozdílu mezi tímto algoritmem a bì¾ným poèítaèovým tøídìním øetìzcù viz <function>natsort</function>. </para> <para> Více informací viz stránka Martina Poola <ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink>. </para> <para> Viz také: <function>sort</function>, <function>natsort</function>, <function>strnatcmp</function> and <function>strnatcasecmp</function>. </para> </refsect1> </refentry> <refentry id="function.next"> <refnamediv> <refname>next</refname> <refpurpose>Posunout interní ukazatel pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>next</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Vrací dal¹í prvek pole nebo <literal>false</literal>, pokud prvky do¹ly. </para> <para> <function>next</function> se chová jako <function>current</function>, s jedním rozdílem: posouvá interní ukazatel pole o jeden prvek a vrací prvek, na který tento ukazatel ukazuje po posunu. To znamená, ¾e vrací dal¹í prvek pole a posouvá interní ukazatel o jeden. Pokud by ukazatel po psunu ukazoval mimo pole, <function>next</function> vrací <literal>false</literal>. <warning> <para> Pokud toto pole obsahuje prázdné prvky, nebo prvky, jejich¾ index je 0, tato funkce vrátí <literal>false</literal> i pro tyto prvky. Ke správnému prùchodu polem, které mù¾e obsahovat prázdné prvky nebo prvky s indexem 0 pou¾ijte <function>each</function>. </para> </warning> </para> <para> Viz také: <function>current</function>, <function>end</function>, <function>prev</function> a <function>reset</function>. </para> </refsect1> </refentry> <refentry id="function.pos"> <refnamediv> <refname>pos</refname> <refpurpose>Získat souèasný prvek pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>pos</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <simpara> Toto je alias k <function>current</function>. </simpara> <para> Viz také: <function>end</function>, <function>next</function>, <function>prev</function> a <function>reset</function>. </para> </refsect1> </refentry> <refentry id="function.prev"> <refnamediv> <refname>prev</refname> <refpurpose>Rewind interní ukazatel pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>prev</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Vrací prvek pole pøed tím prvkem, na který ukazuje interní ukazatel pole, nebo <literal>false</literal>, pokud prvky do¹ly. <warning> <para> Pokud toto pole obsahuje prázdné prvky, tato funkce vrátí <literal>false</literal> i pro tyto prvky. Ke správnému prùchodu polem, které mù¾e obsahovat prázdné prvky pou¾ijte <function>each</function>. </para> </warning> </para> <para> <function>prev</function> se chová stejnì jako <function>next</function>, ale posouvá interní ukazatel pole o jedno místo zpátky místo dopøedu. </para> <para> Viz také: <function>current</function>, <function>end</function>, <function>next</function> a <function>reset</function>. </para> </refsect1> </refentry> <refentry id="function.range"> <refnamediv> <refname>range</refname> <refpurpose>Vytvoøit pole obsahující rozsah integerù</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>array <function>range</function></funcdef> <paramdef>int <parameter>low</parameter></paramdef> <paramdef>int <parameter>high</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>range</function> vrací pole integerù od <parameter>low</parameter> po <parameter>high</parameter> vèetnì. </para> <para> Ukázka pou¾ití viz <function>shuffle</function>. </para> </refsect1> </refentry> <refentry id="function.reset"> <refnamediv> <refname>reset</refname> <refpurpose>Nastavit interní ukazatel pole na jeho první prvek</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>reset</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>reset</function> pøetoèí interní ukazatel pole <parameter>array</parameter> na jeho první prvek. </para> <para> <function>reset</function> vrací hodnotu prvního prvku pole. </para> <para> Viz také: <function>current</function>, <function>each</function>, <function>next</function> a <function>prev</function>. </para> </refsect1> </refentry> <refentry id="function.rsort"> <refnamediv> <refname>rsort</refname> <refpurpose>Tøídit pole sestupnì</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>rsort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>int <parameter><optional>sort_flags</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Tato funkce sestupnì tøídí pole. <example> <title>Ukázka <function>rsort</function></title> <programlisting role="php"> $fruits = array ("lemon", "orange", "banana", "apple"); rsort ($fruits); reset ($fruits); while (list ($key, $val) = each ($fruits)) { echo "$key -&gt; $val\n"; } </programlisting> </example> </para> <para> Tato ukázka zobrazí: </para> <para> <informalexample> <programlisting> fruits[0] = orange fruits[1] = lemon fruits[2] = banana fruits[3] = apple </programlisting> </informalexample> </para> <para> Ovoce bylo setøídìno podle abecedy sestupnì. </para> <para> Vlastnosti tøídìní lze upravit pomocí volitelného argumentu <parameter>sort_flags</parameter>, detaily viz <function>sort</function>. </para> <para> Viz také: <function>arsort</function>, <function>asort</function>, <function>ksort</function>, <function>sort</function> a <function>usort</function>. </para> </refsect1> </refentry> <refentry id="function.shuffle"> <refnamediv> <refname>shuffle</refname> <refpurpose>Zamíchat pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>shuffle</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>shuffle</function> zamíchá (náhodnì zmìní poøadí prvkù) pole. Musíte inicializovat generátor náhodných èísel pomocí <function>srand</function>. <example> <title>Ukázka <function>shuffle</function></title> <programlisting role="php"> $numbers = range (1,20); srand ((double)microtime()*1000000); shuffle ($numbers); while (list (, $number) = each ($numbers)) { echo "$number "; } </programlisting> </example> </para> <para> Viz také: <function>arsort</function>, <function>asort</function>, <function>ksort</function>, <function>rsort</function>, <function>sort</function> a <function>usort</function>. </para> </refsect1> </refentry> <refentry id="function.sizeof"> <refnamediv> <refname>sizeof</refname> <refpurpose>Zjistit poèet prvkù v poli</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>sizeof</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Vrací poèet prvkù v poli. </para> <para> Viz také: <function>count</function>. </para> </refsect1> </refentry> <refentry id="function.sort"> <refnamediv> <refname>sort</refname> <refpurpose>Tøídit pole</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>sort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>int <parameter><optional>sort_flags</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>sort</function> tøídí pole. Prvky se uspoøádají od nejmen¹ího k nejvìt¹ímu. <example> <title>Ukázka <function>sort</function></title> <programlisting role="php"> &lt;?php $fruits = array ("lemon", "orange", "banana", "apple"); sort ($fruits); reset ($fruits); while (list ($key, $val) = each ($fruits)) { echo "fruits[".$key."] = ".$val; } ?&gt; </programlisting> </example> </para> <para> Tato ukázka zobrazí: </para> <para> <informalexample> <programlisting> fruits[0] = apple fruits[1] = banana fruits[2] = lemon fruits[3] = orange </programlisting> </informalexample> </para> <para> Ovoce bylo seøazeno podle abecedy. </para> <para> Vlastnosti tøídìní lze upravit pomocí volitelného argumentu <parameter>sort_flags</parameter>, který mù¾e nabývat tìchto hodnot: </para> <para> Typy tøídìní: <itemizedlist> <listitem> <simpara>SORT_REGULAR - normální porovnávání</simpara> </listitem> <listitem> <simpara>SORT_NUMERIC - numerické porovnávání</simpara> </listitem> <listitem> <simpara>SORT_STRING - textové porovnávání</simpara> </listitem> </itemizedlist> </para> <para> Viz také: <function>arsort</function>, <function>asort</function>, <function>ksort</function>, <function>natsort</function>, <function>natcasesort</function>, <function>rsort</function>, <function>usort</function>, <function>array_multisort</function> a <function>uksort</function>. </para> <note> <para> Druhý argument byl pøidán v PHP 4. </para> </note> </refsect1> </refentry> <refentry id="function.uasort"> <refnamediv> <refname>uasort</refname> <refpurpose> Tøídit pole pomocí u¾ivatelsky definované porovnávací funkce se zachováním klíèù </refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>uasort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>function <parameter>cmp_function</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Tato funkce tøídí pole tak, ¾e si indexy uchovávají spojení s hodnotami. To je u¾iteèné hlavnì pøi tøídìní asociativních polí, kde je dùle¾ité poøadí prvkù. Srovnávací funkce je u¾ivatelsky definována. </para> <note> <para> Ukázky u¾ivatelsky definovaných porovnávacích funkcí viz <function>usort</function> a <function>uksort</function>. </para> </note> <para> Viz také: <function>usort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>, <function>ksort</function> a <function>rsort</function>. </para> </refsect1> </refentry> <refentry id="function.uksort"> <refnamediv> <refname>uksort</refname> <refpurpose> Tøídit pole podle klíèù pomocí u¾ivatelsky definovane porovnávací funkce </refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>uksort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>function <parameter>cmp_function</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Tato funkce tøídí pole podle klíèù pomocí u¾ivatelsky definované porovnávací funkce. Pokud potøebujete tøídit pole podle komplikovanìj¹ích kritérií, mìli byste pou¾ít tuto funkci. </para> <para> <example> <title>Ukázka <function>uksort</function></title> <programlisting role="php"> function cmp ($a, $b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; } $a = array (4 =&gt; "four", 3 =&gt; "three", 20 =&gt; "twenty", 10 =&gt; "ten"); uksort ($a, "cmp"); while (list ($key, $value) = each ($a)) { echo "$key: $value\n"; } </programlisting> </example> </para> <para> Tato ukázka zobrazí: </para> <para> <informalexample> <programlisting> 20: twenty 10: ten 4: four 3: three </programlisting> </informalexample> </para> <para> Viz také: <function>usort</function>, <function>uasort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>, <function>ksort</function>, <function>natsort</function> a <function>rsort</function>. </para> </refsect1> </refentry> <refentry id="function.usort"> <refnamediv> <refname>usort</refname> <refpurpose> Tøídit pole podle hodnot pomocí u¾ivatelsky definované porovnávací funkce </refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>usort</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> <paramdef>string <parameter>cmp_function</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Tato funkce tøídí pole podle hodnot pomocí u¾ivatelsky definované porovnávací funkce. Pokud potøebujete tøídit pole podle komplikovanìj¹ích kritérií, mìli byste pou¾ít tuto funkci. </para> <para> Porovnávací funkce musí vrace integer men¹í ne¾ 0, 0, a vìt¹í ne¾ 0, pokud je první argument men¹í ne¾, stejný, nebo vìt¹í ne¾ druhý argument. Pokud jsou dvì porovnávané hodnoty stejné, jejich poøadí v tøídìném poli je nedefinováno. </para> <para> <example> <title>Ukázka <function>usort</function></title> <programlisting role="php"> function cmp ($a, $b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; } $a = array (3, 2, 5, 6, 1); usort ($a, "cmp"); while (list ($key, $value) = each ($a)) { echo "$key: $value\n"; } </programlisting> </example> </para> <para> Tato ukázka zobrazí: </para> <para> <informalexample> <programlisting> 0: 6 1: 5 2: 3 3: 2 4: 1 </programlisting> </informalexample> </para> <note> <para> V tomto jednoduchém pøípadì by pochopitelnì bylo vhodnìj¹í pou¾ít <function>rsort</function>. </para> </note> <para> <example> <title> Ukázka <function>usort</function> s vícerozmìrným polem </title> <programlisting role="php"> function cmp ($a, $b) { return strcmp($a["fruit"],$b["fruit"]); } $fruits[0]["fruit"] = "lemons"; $fruits[1]["fruit"] = "apples"; $fruits[2]["fruit"] = "grapes"; usort($fruits, "cmp"); while (list ($key, $value) = each ($fruits)) { echo "\$fruits[$key]: " . $value["fruit"] . "\n"; } </programlisting> </example> </para> <para> Pøi tøídìní vícerozmìrného pole $a a $b obsahují reference na první index pole. </para> <para> Tato ukázka zobrazí: </para> <para> <informalexample> <programlisting> $fruits[0]: apples $fruits[1]: grapes $fruits[2]: lemons </programlisting> </informalexample> </para> <para> <warning> <para> Pou¾itá quicksort funkce v nìkterých C knihovnách (napø. na systémech Solaris) mù¾e zpùsobit zhroucení PHP, pokud porovnávací funkce nevrací konsistentní hodnoty. </para> </warning> </para> <para> Viz také: <function>uasort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>, <function>ksort</function>, <function>natsort</function> a <function>rsort</function>. </para> </refsect1> </refentry> </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: -->
« previous php.doc (#969334167) next »