cvs: phpdoc-cs /reference/array/functions array.xml count.xml in-array.xml reset.xml sort.xml /reference/strings/functions explode.xml implode.xml
| From: | Jakub Vrana | Date: | Wed, 07 Jan 2004 12:44:49 +0000 |
| Subject: | cvs: phpdoc-cs /reference/array/functions array.xml count.xml in-array.xml reset.xml sort.xml /reference/strings/functions explode.xml implode.xml | ||
| Groups: | php.doc.cs | ||
| Request: | Send a blank email to doc-cs+get-109@lists.php.net to get a copy of this message | ||
vrana Wed Jan 7 07:44:49 2004 EDT
Modified files:
/phpdoc-cs/reference/array/functions array.xml count.xml
in-array.xml reset.xml
sort.xml
/phpdoc-cs/reference/strings/functions explode.xml implode.xml
Log:
Up to dated
Index: phpdoc-cs/reference/array/functions/array.xml diff -u phpdoc-cs/reference/array/functions/array.xml:1.1 phpdoc-cs/reference/array/functions/array.xml:1.2 --- phpdoc-cs/reference/array/functions/array.xml:1.1 Sun Apr 14 19:45:31 2002 +++ phpdoc-cs/reference/array/functions/array.xml Wed Jan 7 07:44:48 2004 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/array.xml, last change in rev 1.1 --> -<!-- last change to 'array' in en/ tree in rev 1.110 --> +<!-- EN-Revision: 1.14 Maintainer: luk Status: ready --> <refentry id="function.array"> <refnamediv> <refname>array</refname> @@ -15,8 +14,10 @@ <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> </methodsynopsis> <para> - Vrací pole argumentù. Argumentùm mù¾e být pøiøazen index pomocí operátoru - <literal>=></literal>. + Vrací pole argumentù. Argumentùm mù¾e být pøiøazen + index pomocí operátoru <literal>=></literal>. Viz èást + o <link linkend="language.types.array">typu pole</link> pro bli¾¹í + vysvìtlení toho, co to pole je. </para> <para> <note> @@ -27,7 +28,7 @@ </note> </para> <para> - Syntaxe "index => hodnota", s èárko jako oddìlovaèem, definuje indexy a + Syntaxe "index => hodnota", s èárkou 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.: @@ -40,11 +41,15 @@ <example> <title>Ukázka <function>array</function></title> <programlisting role="php"> -$fruits = array ( - "fruits" => array ("a"=>"orange", "b"=>"banana", "c"=>"apple"), - "numbers" => array (1, 2, 3, 4, 5, 6), - "holes" => array ("first", 5 => "second", "third") -); +<![CDATA[ +<?php +$ovoce = array ( + "fruits" => array("a" => "pomeranè", "b" => "banán", "c" => "jablko"), + "numbers" => array(1, 2, 3, 4, 5, 6), + "holes" => array("první", 5 => "druhý", "tøetí") +) +?> +]]> </programlisting> </example> </para> @@ -52,13 +57,18 @@ <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); +<![CDATA[ +<?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> +<![CDATA[ Array ( [0] => 1 @@ -69,6 +79,7 @@ [8] => 1 [9] => 19 ) +]]> </programlisting> </informalexample> Index 3 je definován dvakrát, a podr¾í si poslední hodnotu 13. Index 4 je @@ -80,24 +91,33 @@ <example> <title>Index zaèínající 1 s <function>array</function></title> <programlisting role="php"> - $firstquarter = array(1 => 'January', 'February', 'March'); - print_r($firstquarter); +<![CDATA[ +<?php +$prvni_kvartal = array(1 => 'leden', 'únor', 'bøezen'); +print_r($prvni_kvartal); +?> +]]> </programlisting> </example> toto bude výstup: <informalexample> <programlisting> +<![CDATA[ Array ( - [1] => 'January' - [2] => 'February' - [3] => 'March' + [1] => leden + [2] => únor + [3] => bøezen ) +]]> </programlisting> </informalexample> </para> <para> - Viz také: <function>list</function>. + Viz také <function>array_pad</function>, + <function>list</function>, + <link linkend="control-structures.foreach">foreach</link> a + <function>range</function>. </para> </refsect1> </refentry> Index: phpdoc-cs/reference/array/functions/count.xml diff -u phpdoc-cs/reference/array/functions/count.xml:1.1 phpdoc-cs/reference/array/functions/count.xml:1.2 --- phpdoc-cs/reference/array/functions/count.xml:1.1 Sun Apr 14 19:45:36 2002 +++ phpdoc-cs/reference/array/functions/count.xml Wed Jan 7 07:44:48 2004 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/array.xml, last change in rev 1.1 --> -<!-- last change to 'count' in en/ tree in rev 1.2 --> +<!-- EN-Revision: 1.11 Maintainer: luk Status: ready --> <refentry id="function.count"> <refnamediv> <refname>count</refname> @@ -11,42 +10,92 @@ <methodsynopsis> <type>int</type><methodname>count</methodname> <methodparam><type>mixed</type><parameter>var</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> <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. + Vrací <literal>1</literal>, pokud <parameter>var</parameter> není pole + (výjimka: <literal>count(&null;)</literal> je + <literal>0</literal>). </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> + Pokud je volitelný parametr <parameter>mode</parameter> nastaven na + <constant>COUNT_RECURSIVE</constant> (nebo 1), tak funkce <function>count</function> + spoèítá pole rekurzivnì. To je obzvlá¹tì u¾iteèné pro + spoèítání v¹ech prvkù vícerozmìrného pole. Výchozí + hodota parametru <parameter>mode</parameter> je <literal>0</literal>. + </para> + <caution> + <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> + </caution> + <para> + Bli¾¹í vysvìtlení toho, jak jsou v PHP implementována a + pou¾ívána pole, najdete v èásti + <link linkend="language.types.array">Pole</link> </para> <para> <example> <title>Ukázka <function>count</function></title> <programlisting role="php"> + <!-- TODO: examples about count(null), count(false), count(object).. --> +<![CDATA[ +<?php $a[0] = 1; $a[1] = 3; $a[2] = 5; -$result = count ($a); -//$result == 3 +$result = count($a); +// $result == 3 + +$b[0] = 7; +$b[5] = 9; +$b[10] = 11; +$result = count($b); +// $result == 3; +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title> + pøíklad na rekurzivní <function>count</function> (PHP >= 4.2.0) + </title> + <programlisting role="php"> +<![CDATA[ +<?php +$jidlo = array('ovoce' => array('pomeranè', 'banán', 'jablko'), + 'zelenina' => array('mrkev', 'petr¾el', 'hrá¹ek')); + +// rekurzivní poèet +echo count($jidlo, COUNT_RECURSIVE); // vypí¹e 8 + +// normálí poèet +echo count($jidlo); // vypí¹e 2 + +?> +]]> </programlisting> </example> </para> + <note> + <para> + Funkce <function>sizeof</function> je + <link linkend="aliases">alias</link> funkce <function>count</function>. + </para> + </note> <para> - Viz také: <function>sizeof</function>, + Viz také <function>is_array</function>, <function>isset</function> a - <function>is_array</function>. + <function>strlen</function>. </para> </refsect1> </refentry> Index: phpdoc-cs/reference/array/functions/in-array.xml diff -u phpdoc-cs/reference/array/functions/in-array.xml:1.1 phpdoc-cs/reference/array/functions/in-array.xml:1.2 --- phpdoc-cs/reference/array/functions/in-array.xml:1.1 Sun Apr 14 19:45:36 2002 +++ phpdoc-cs/reference/array/functions/in-array.xml Wed Jan 7 07:44:48 2004 @@ -1,10 +1,9 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/array.xml, last change in rev 1.1 --> -<!-- last change to 'in-array' in en/ tree in rev 1.56 --> +<!-- EN-Revision: 1.11 Maintainer: luk Status: ready --> <refentry id="function.in-array"> <refnamediv> <refname>in_array</refname> - <refpurpose>Vrátit &true;, pokud v poli existuje daná hodnota</refpurpose> + <refpurpose>Ovìøit, zda v poli existuje daná hodnota</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -12,48 +11,123 @@ <type>bool</type><methodname>in_array</methodname> <methodparam><type>mixed</type><parameter>needle</parameter></methodparam> <methodparam><type>array</type><parameter>haystack</parameter></methodparam> - <methodparam><type>bool</type><parameter>strict</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>strict</parameter></methodparam> </methodsynopsis> <para> - Hledá v <parameter>haystack</parameter> <parameter>needle</parameter> - a pokud ji najde, vrací &true;, jinak - &false;. + Hledá v <parameter>haystack</parameter> hodnotu + <parameter>needle</parameter> a pokud ji najde, + vrací &true;, jinak &false;. </para> <para> - Pokud je tøetí argument <parameter>strict</parameter> &true;, + Pokud je tøetí argument <parameter>strict</parameter> nastaven na &true;, tak funkce <function>in_array</function> také kontroluje typ <parameter>needle</parameter> v <parameter>haystack</parameter>. </para> + <note> + <para> + Pokud je <parameter>needle</parameter> øetìzec, tak porovnání rozli¹uje + velká a malá písmena. + </para> + </note> + <note> + <para> + V PHP star¹ích ne¾ 4.2.0 nemohl být parametr <parameter>needle</parameter> + pole. + </para> + </note> <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"; - } +<![CDATA[ +<?php +$os = array("Mac", "NT", "Irix", "Linux"); +if (in_array("Irix", $os)) { + echo "Máme Irix"; +} +if (in_array("mac", $os)) { + echo "Máme mac"; +} +?> +]]> </programlisting> + <para> + Druhá podmínka neuspìje, proto¾e funkce <function>in_array</function> + rozli¹uje velká a malá písmen, tak¾e program vypí¹e: + </para> + <screen> +<![CDATA[ +Máme Irix +]]> + </screen> </example> </para> <para> <example> - <title>Ukázka <function>in_array</function> s argumentem <parameter>strict</parameter></title> + <title>Ukázka <function>in_array</function> s parametrem <parameter>strict</parameter></title> <programlisting role="php"> +<![CDATA[ <?php $a = array('1.10', 12.4, 1.13); -if (in_array('12.4', $a, true)) - echo "'12.4' found with strict check\n"; -if (in_array(1.13, $a, true)) - echo "1.13 found with strict check\n"; +if (in_array('12.4', $a, true)) { + echo "'12.4' bylo nalezeno s omezením strict\n"; +} + +if (in_array(1.13, $a, true)) { + echo "1.13 bylo nalezeno s omezením strict\n"; +} ?> +]]> + </programlisting> + <para> + Vypí¹e: + </para> + <screen> +<![CDATA[ +1.13 bylo nalezeno s omezením strict +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title><function>in_array</function> pøi hledání pole</title> + <programlisting role="php"> +<![CDATA[ +<?php +$a = array(array('p', 'h'), array('p', 'r'), 'o'); + +if (in_array(array('p', 'h'), $a)) { + echo "'ph' nalezeno\n"; +} -// Výstup bude: +if (in_array(array('f', 'i'), $a)) { + echo "'fi' nalezeno\n"; +} -1.13 found with strict check +if (in_array('o', $a)) { + echo "'o' nalezeno\n"; +} +?> +]]> </programlisting> + <para> + Vypí¹e: + </para> + <screen> +<![CDATA[ + 'ph' nalezeno + 'o' nalezeno +]]> + </screen> </example> </para> + <para> + Viz také <function>array_search</function>, + <function>array_key_exists</function> a + <function>isset</function>. + </para> </refsect1> </refentry> Index: phpdoc-cs/reference/array/functions/reset.xml diff -u phpdoc-cs/reference/array/functions/reset.xml:1.1 phpdoc-cs/reference/array/functions/reset.xml:1.2 --- phpdoc-cs/reference/array/functions/reset.xml:1.1 Sun Apr 14 19:45:37 2002 +++ phpdoc-cs/reference/array/functions/reset.xml Wed Jan 7 07:44:48 2004 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/array.xml, last change in rev 1.1 --> -<!-- last change to 'reset' in en/ tree in rev 1.2 --> +<!-- EN-Revision: 1.10 Maintainer: luk Status: ready --> <refentry id="function.reset"> <refnamediv> <refname>reset</refname> @@ -14,16 +13,39 @@ </methodsynopsis> <para> <function>reset</function> pøetoèí interní ukazatel pole - <parameter>array</parameter> na jeho první prvek. + <parameter>array</parameter> na jeho první prvek + a vrátí hodnotu prvního prvku pole. </para> <para> - <function>reset</function> vrací hodnotu prvního prvku pole. + <example> + <title>Pøíklad funkce <function>reset</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +$array = array('krok jedna', 'krok dva', 'krok tøi', 'krok ètyøi'); + +// na zaèátku je ukazatel na prvním prvku +echo current($array) . "<br />\n"; // "krok jedna" + +// pøeskoèit dva prvky +next($array); +next($array); +echo current($array) . "<br />\n"; // "krok tøi" + +// vynulovat ukazatel, zaèít znovu na prvním prvku +reset($array); +echo current($array) . "<br />\n"; // "krok jedna" + +?> +]]> + </programlisting> + </example> </para> <para> - Viz také: <function>current</function>, - <function>each</function>, - <function>next</function> a - <function>prev</function>. + Viz také <function>current</function>, + <function>each</function>, <function>next</function> + a <function>prev</function>. </para> </refsect1> </refentry> Index: phpdoc-cs/reference/array/functions/sort.xml diff -u phpdoc-cs/reference/array/functions/sort.xml:1.1 phpdoc-cs/reference/array/functions/sort.xml:1.2 --- phpdoc-cs/reference/array/functions/sort.xml:1.1 Sun Apr 14 19:45:38 2002 +++ phpdoc-cs/reference/array/functions/sort.xml Wed Jan 7 07:44:48 2004 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/array.xml, last change in rev 1.1 --> -<!-- last change to 'sort' in en/ tree in rev 1.2 --> +<!-- EN-Revision: 1.10 Maintainer: luk Status: ready --> <refentry id="function.sort"> <refnamediv> <refname>sort</refname> @@ -16,19 +15,33 @@ <para> <function>sort</function> tøídí pole. Prvky se uspoøádají od nejmen¹ího k nejvìt¹ímu. + </para> + <note> + <simpara> + Tato funkce pøiøadí prvkùm pole nové klíèe. + Odstraní jakékoliv existující + klíèe. Nepøeuspoøádá klíèe, jak byste mo¾ná èekali. + </simpara> + </note> + <para> + &return.success; + </para> + <para> <example> <title>Ukázka <function>sort</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php -$fruits = array ("lemon", "orange", "banana", "apple"); -sort ($fruits); -reset ($fruits); -while (list ($key, $val) = each ($fruits)) { - echo "fruits[".$key."] = ".$val; +$ovoce = array("citrón", "pomeranè", "banán", "jablko"); +sort($ovoce); +reset($ovoce); +while (list($key, $val) = each($ovoce)) { + echo "ovoce[" . $key . "] = " . $val . "\n"; } -?> +?> +]]> </programlisting> </example> </para> @@ -38,10 +51,12 @@ <para> <informalexample> <programlisting> -fruits[0] = apple -fruits[1] = banana -fruits[2] = lemon -fruits[3] = orange +<![CDATA[ +fruits[0] = banán +fruits[1] = citrón +fruits[2] = jablko +fruits[3] = pomeranè +]]> </programlisting> </informalexample> </para> @@ -66,22 +81,19 @@ </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. + Druhý parametr byl pøidán v PHP 4. </para> </note> + <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> </refsect1> </refentry> Index: phpdoc-cs/reference/strings/functions/explode.xml diff -u phpdoc-cs/reference/strings/functions/explode.xml:1.2 phpdoc-cs/reference/strings/functions/explode.xml:1.3 --- phpdoc-cs/reference/strings/functions/explode.xml:1.2 Sun Jun 9 15:27:27 2002 +++ phpdoc-cs/reference/strings/functions/explode.xml Wed Jan 7 07:44:49 2004 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/strings.xml, last change in rev 1.1 --> -<!-- last change to 'explode' in en/ tree in rev 1.2 --> +<!-- EN-Revision: 1.6 Maintainer: luk Status: ready --> <refentry id="function.explode"> <refnamediv> <refname>explode</refname> @@ -20,7 +19,7 @@ tvoøených øetìzcem <parameter>separator</parameter>. Pokud je definován <parameter>limit</parameter>, vrácené pole bude obsahovat maximálnì <parameter>limit</parameter> prvkù, a poslední prvek bude - obsahovat celý zbytek <parameter>string</parameter>. + obsahovat celý zbytek parametru <parameter>string</parameter>. </para> <note> <para> @@ -30,9 +29,14 @@ v <parameter>string</parameter>, pak <function>explode</function> vrátí pole obsahující celý <parameter>string</parameter>. </para> - + <para> + I kdy¾ <function>implode</function> mù¾e z historických dùvodù pøijímat + argumenty v obou mo¾ných poøadích, <function>explode</function> nemù¾e. + Musíte zajistit, aby byl argument <parameter>separator</parameter> pøed + argumentem <parameter>string</parameter>. + </para> <para> - Argument <parameter>limit</parameter> byl pøidán v PHP 4.0.1 + Parametr <parameter>limit</parameter> byl pøidán v PHP 4.0.1 </para> </note> <para> @@ -40,25 +44,26 @@ <title>Ukázka <function>explode</function></title> <programlisting role="php"> <![CDATA[ -$pizza = "piece1 piece2 piece3 piece4 piece5 piece6"; -$pieces = explode (" ", $pizza); +<?php +// Pøíklad 1 +$pizza = "díl1 díl2 díl3 díl4 díl5 díl6"; +$dily = explode(" ", $pizza); +echo $dily[0]; // díl1 +echo $dily[1]; // díl2 +// Pøíklad 2 $data = "foo:*:1023:1000::/home/foo:/bin/sh"; -list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":",$data); +list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data); +echo $user; // foo +echo $pass; // * + +?> ]]> </programlisting> </example> </para> - <note> - <para> - I kdy¾ <function>implode</function> mù¾e z historických dùvodù pøijímat - argumenty v obou mo¾ných poøadích, <function>explode</function> nemù¾e. - Musíte se ujistit, ¾e je argument <parameter>separator</parameter> pøed - argumentem <parameter>string</parameter>. - </para> - </note> <para> - Viz také: + Viz také <function>preg_split</function>, <function>spliti</function>, <function>split</function> a Index: phpdoc-cs/reference/strings/functions/implode.xml diff -u phpdoc-cs/reference/strings/functions/implode.xml:1.1 phpdoc-cs/reference/strings/functions/implode.xml:1.2 --- phpdoc-cs/reference/strings/functions/implode.xml:1.1 Sun Apr 14 19:48:09 2002 +++ phpdoc-cs/reference/strings/functions/implode.xml Wed Jan 7 07:44:49 2004 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/strings.xml, last change in rev 1.1 --> -<!-- last change to 'implode' in en/ tree in rev 1.2 --> +<!-- EN-Revision: 1.10 Maintainer: luk Status: ready --> <refentry id="function.implode"> <refnamediv> <refname>implode</refname> @@ -19,7 +18,16 @@ <example> <title>Ukázka <function>implode</function></title> <programlisting role="php"> -$colon_separated = implode (":", $array); +<![CDATA[ +<?php + +$array = array('pøíjmení', 'e-mail', 'telefon'); +$oddelene_carkami = implode(",", $array); + +echo $oddelene_carkami; // pøíjmení,e-mail,telefon + +?> +]]> </programlisting> </example> </para> @@ -31,10 +39,16 @@ poøadí argumentù. </para> </note> + <note> + <para> + Od PHP 4.3.0 je parametr <parameter>glue</parameter> + volitelný a jeho výchozí hodnota je prázdný øetìzec (''). Toto pou¾ití v¹ak + nedoporuèujeme, pro zaji¹tìní kompatibility se star¹ími verzemi je lep¹í v¾dy + pou¾ívat dva parametry. + </para> + </note> <simpara> - Viz také: <function>explode</function>, - <function>join</function> a - <function>split</function>. + Viz také <function>explode</function> a <function>split</function>. </simpara> </refsect1> </refentry>
Index: phpdoc-cs/reference/array/functions/array.xml diff -u phpdoc-cs/reference/array/functions/array.xml:1.1 phpdoc-cs/reference/array/functions/array.xml:1.2 --- phpdoc-cs/reference/array/functions/array.xml:1.1 Sun Apr 14 19:45:31 2002 +++ phpdoc-cs/reference/array/functions/array.xml Wed Jan 7 07:44:48 2004 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/array.xml, last change in rev 1.1 --> -<!-- last change to 'array' in en/ tree in rev 1.110 --> +<!-- EN-Revision: 1.14 Maintainer: luk Status: ready --> <refentry id="function.array"> <refnamediv> <refname>array</refname> @@ -15,8 +14,10 @@ <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> </methodsynopsis> <para> - Vrací pole argumentù. Argumentùm mù¾e být pøiøazen index pomocí operátoru - <literal>=></literal>. + Vrací pole argumentù. Argumentùm mù¾e být pøiøazen + index pomocí operátoru <literal>=></literal>. Viz èást + o <link linkend="language.types.array">typu pole</link> pro bli¾¹í + vysvìtlení toho, co to pole je. </para> <para> <note> @@ -27,7 +28,7 @@ </note> </para> <para> - Syntaxe "index => hodnota", s èárko jako oddìlovaèem, definuje indexy a + Syntaxe "index => hodnota", s èárkou 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.: @@ -40,11 +41,15 @@ <example> <title>Ukázka <function>array</function></title> <programlisting role="php"> -$fruits = array ( - "fruits" => array ("a"=>"orange", "b"=>"banana", "c"=>"apple"), - "numbers" => array (1, 2, 3, 4, 5, 6), - "holes" => array ("first", 5 => "second", "third") -); +<![CDATA[ +<?php +$ovoce = array ( + "fruits" => array("a" => "pomeranè", "b" => "banán", "c" => "jablko"), + "numbers" => array(1, 2, 3, 4, 5, 6), + "holes" => array("první", 5 => "druhý", "tøetí") +) +?> +]]> </programlisting> </example> </para> @@ -52,13 +57,18 @@ <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); +<![CDATA[ +<?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> +<![CDATA[ Array ( [0] => 1 @@ -69,6 +79,7 @@ [8] => 1 [9] => 19 ) +]]> </programlisting> </informalexample> Index 3 je definován dvakrát, a podr¾í si poslední hodnotu 13. Index 4 je @@ -80,24 +91,33 @@ <example> <title>Index zaèínající 1 s <function>array</function></title> <programlisting role="php"> - $firstquarter = array(1 => 'January', 'February', 'March'); - print_r($firstquarter); +<![CDATA[ +<?php +$prvni_kvartal = array(1 => 'leden', 'únor', 'bøezen'); +print_r($prvni_kvartal); +?> +]]> </programlisting> </example> toto bude výstup: <informalexample> <programlisting> +<![CDATA[ Array ( - [1] => 'January' - [2] => 'February' - [3] => 'March' + [1] => leden + [2] => únor + [3] => bøezen ) +]]> </programlisting> </informalexample> </para> <para> - Viz také: <function>list</function>. + Viz také <function>array_pad</function>, + <function>list</function>, + <link linkend="control-structures.foreach">foreach</link> a + <function>range</function>. </para> </refsect1> </refentry> Index: phpdoc-cs/reference/array/functions/count.xml diff -u phpdoc-cs/reference/array/functions/count.xml:1.1 phpdoc-cs/reference/array/functions/count.xml:1.2 --- phpdoc-cs/reference/array/functions/count.xml:1.1 Sun Apr 14 19:45:36 2002 +++ phpdoc-cs/reference/array/functions/count.xml Wed Jan 7 07:44:48 2004 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/array.xml, last change in rev 1.1 --> -<!-- last change to 'count' in en/ tree in rev 1.2 --> +<!-- EN-Revision: 1.11 Maintainer: luk Status: ready --> <refentry id="function.count"> <refnamediv> <refname>count</refname> @@ -11,42 +10,92 @@ <methodsynopsis> <type>int</type><methodname>count</methodname> <methodparam><type>mixed</type><parameter>var</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> <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. + Vrací <literal>1</literal>, pokud <parameter>var</parameter> není pole + (výjimka: <literal>count(&null;)</literal> je + <literal>0</literal>). </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> + Pokud je volitelný parametr <parameter>mode</parameter> nastaven na + <constant>COUNT_RECURSIVE</constant> (nebo 1), tak funkce <function>count</function> + spoèítá pole rekurzivnì. To je obzvlá¹tì u¾iteèné pro + spoèítání v¹ech prvkù vícerozmìrného pole. Výchozí + hodota parametru <parameter>mode</parameter> je <literal>0</literal>. + </para> + <caution> + <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> + </caution> + <para> + Bli¾¹í vysvìtlení toho, jak jsou v PHP implementována a + pou¾ívána pole, najdete v èásti + <link linkend="language.types.array">Pole</link> </para> <para> <example> <title>Ukázka <function>count</function></title> <programlisting role="php"> + <!-- TODO: examples about count(null), count(false), count(object).. --> +<![CDATA[ +<?php $a[0] = 1; $a[1] = 3; $a[2] = 5; -$result = count ($a); -//$result == 3 +$result = count($a); +// $result == 3 + +$b[0] = 7; +$b[5] = 9; +$b[10] = 11; +$result = count($b); +// $result == 3; +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title> + pøíklad na rekurzivní <function>count</function> (PHP >= 4.2.0) + </title> + <programlisting role="php"> +<![CDATA[ +<?php +$jidlo = array('ovoce' => array('pomeranè', 'banán', 'jablko'), + 'zelenina' => array('mrkev', 'petr¾el', 'hrá¹ek')); + +// rekurzivní poèet +echo count($jidlo, COUNT_RECURSIVE); // vypí¹e 8 + +// normálí poèet +echo count($jidlo); // vypí¹e 2 + +?> +]]> </programlisting> </example> </para> + <note> + <para> + Funkce <function>sizeof</function> je + <link linkend="aliases">alias</link> funkce <function>count</function>. + </para> + </note> <para> - Viz také: <function>sizeof</function>, + Viz také <function>is_array</function>, <function>isset</function> a - <function>is_array</function>. + <function>strlen</function>. </para> </refsect1> </refentry> Index: phpdoc-cs/reference/array/functions/in-array.xml diff -u phpdoc-cs/reference/array/functions/in-array.xml:1.1 phpdoc-cs/reference/array/functions/in-array.xml:1.2 --- phpdoc-cs/reference/array/functions/in-array.xml:1.1 Sun Apr 14 19:45:36 2002 +++ phpdoc-cs/reference/array/functions/in-array.xml Wed Jan 7 07:44:48 2004 @@ -1,10 +1,9 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/array.xml, last change in rev 1.1 --> -<!-- last change to 'in-array' in en/ tree in rev 1.56 --> +<!-- EN-Revision: 1.11 Maintainer: luk Status: ready --> <refentry id="function.in-array"> <refnamediv> <refname>in_array</refname> - <refpurpose>Vrátit &true;, pokud v poli existuje daná hodnota</refpurpose> + <refpurpose>Ovìøit, zda v poli existuje daná hodnota</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -12,48 +11,123 @@ <type>bool</type><methodname>in_array</methodname> <methodparam><type>mixed</type><parameter>needle</parameter></methodparam> <methodparam><type>array</type><parameter>haystack</parameter></methodparam> - <methodparam><type>bool</type><parameter>strict</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>strict</parameter></methodparam> </methodsynopsis> <para> - Hledá v <parameter>haystack</parameter> <parameter>needle</parameter> - a pokud ji najde, vrací &true;, jinak - &false;. + Hledá v <parameter>haystack</parameter> hodnotu + <parameter>needle</parameter> a pokud ji najde, + vrací &true;, jinak &false;. </para> <para> - Pokud je tøetí argument <parameter>strict</parameter> &true;, + Pokud je tøetí argument <parameter>strict</parameter> nastaven na &true;, tak funkce <function>in_array</function> také kontroluje typ <parameter>needle</parameter> v <parameter>haystack</parameter>. </para> + <note> + <para> + Pokud je <parameter>needle</parameter> øetìzec, tak porovnání rozli¹uje + velká a malá písmena. + </para> + </note> + <note> + <para> + V PHP star¹ích ne¾ 4.2.0 nemohl být parametr <parameter>needle</parameter> + pole. + </para> + </note> <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"; - } +<![CDATA[ +<?php +$os = array("Mac", "NT", "Irix", "Linux"); +if (in_array("Irix", $os)) { + echo "Máme Irix"; +} +if (in_array("mac", $os)) { + echo "Máme mac"; +} +?> +]]> </programlisting> + <para> + Druhá podmínka neuspìje, proto¾e funkce <function>in_array</function> + rozli¹uje velká a malá písmen, tak¾e program vypí¹e: + </para> + <screen> +<![CDATA[ +Máme Irix +]]> + </screen> </example> </para> <para> <example> - <title>Ukázka <function>in_array</function> s argumentem <parameter>strict</parameter></title> + <title>Ukázka <function>in_array</function> s parametrem <parameter>strict</parameter></title> <programlisting role="php"> +<![CDATA[ <?php $a = array('1.10', 12.4, 1.13); -if (in_array('12.4', $a, true)) - echo "'12.4' found with strict check\n"; -if (in_array(1.13, $a, true)) - echo "1.13 found with strict check\n"; +if (in_array('12.4', $a, true)) { + echo "'12.4' bylo nalezeno s omezením strict\n"; +} + +if (in_array(1.13, $a, true)) { + echo "1.13 bylo nalezeno s omezením strict\n"; +} ?> +]]> + </programlisting> + <para> + Vypí¹e: + </para> + <screen> +<![CDATA[ +1.13 bylo nalezeno s omezením strict +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title><function>in_array</function> pøi hledání pole</title> + <programlisting role="php"> +<![CDATA[ +<?php +$a = array(array('p', 'h'), array('p', 'r'), 'o'); + +if (in_array(array('p', 'h'), $a)) { + echo "'ph' nalezeno\n"; +} -// Výstup bude: +if (in_array(array('f', 'i'), $a)) { + echo "'fi' nalezeno\n"; +} -1.13 found with strict check +if (in_array('o', $a)) { + echo "'o' nalezeno\n"; +} +?> +]]> </programlisting> + <para> + Vypí¹e: + </para> + <screen> +<![CDATA[ + 'ph' nalezeno + 'o' nalezeno +]]> + </screen> </example> </para> + <para> + Viz také <function>array_search</function>, + <function>array_key_exists</function> a + <function>isset</function>. + </para> </refsect1> </refentry> Index: phpdoc-cs/reference/array/functions/reset.xml diff -u phpdoc-cs/reference/array/functions/reset.xml:1.1 phpdoc-cs/reference/array/functions/reset.xml:1.2 --- phpdoc-cs/reference/array/functions/reset.xml:1.1 Sun Apr 14 19:45:37 2002 +++ phpdoc-cs/reference/array/functions/reset.xml Wed Jan 7 07:44:48 2004 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/array.xml, last change in rev 1.1 --> -<!-- last change to 'reset' in en/ tree in rev 1.2 --> +<!-- EN-Revision: 1.10 Maintainer: luk Status: ready --> <refentry id="function.reset"> <refnamediv> <refname>reset</refname> @@ -14,16 +13,39 @@ </methodsynopsis> <para> <function>reset</function> pøetoèí interní ukazatel pole - <parameter>array</parameter> na jeho první prvek. + <parameter>array</parameter> na jeho první prvek + a vrátí hodnotu prvního prvku pole. </para> <para> - <function>reset</function> vrací hodnotu prvního prvku pole. + <example> + <title>Pøíklad funkce <function>reset</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +$array = array('krok jedna', 'krok dva', 'krok tøi', 'krok ètyøi'); + +// na zaèátku je ukazatel na prvním prvku +echo current($array) . "<br />\n"; // "krok jedna" + +// pøeskoèit dva prvky +next($array); +next($array); +echo current($array) . "<br />\n"; // "krok tøi" + +// vynulovat ukazatel, zaèít znovu na prvním prvku +reset($array); +echo current($array) . "<br />\n"; // "krok jedna" + +?> +]]> + </programlisting> + </example> </para> <para> - Viz také: <function>current</function>, - <function>each</function>, - <function>next</function> a - <function>prev</function>. + Viz také <function>current</function>, + <function>each</function>, <function>next</function> + a <function>prev</function>. </para> </refsect1> </refentry> Index: phpdoc-cs/reference/array/functions/sort.xml diff -u phpdoc-cs/reference/array/functions/sort.xml:1.1 phpdoc-cs/reference/array/functions/sort.xml:1.2 --- phpdoc-cs/reference/array/functions/sort.xml:1.1 Sun Apr 14 19:45:38 2002 +++ phpdoc-cs/reference/array/functions/sort.xml Wed Jan 7 07:44:48 2004 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/array.xml, last change in rev 1.1 --> -<!-- last change to 'sort' in en/ tree in rev 1.2 --> +<!-- EN-Revision: 1.10 Maintainer: luk Status: ready --> <refentry id="function.sort"> <refnamediv> <refname>sort</refname> @@ -16,19 +15,33 @@ <para> <function>sort</function> tøídí pole. Prvky se uspoøádají od nejmen¹ího k nejvìt¹ímu. + </para> + <note> + <simpara> + Tato funkce pøiøadí prvkùm pole nové klíèe. + Odstraní jakékoliv existující + klíèe. Nepøeuspoøádá klíèe, jak byste mo¾ná èekali. + </simpara> + </note> + <para> + &return.success; + </para> + <para> <example> <title>Ukázka <function>sort</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php -$fruits = array ("lemon", "orange", "banana", "apple"); -sort ($fruits); -reset ($fruits); -while (list ($key, $val) = each ($fruits)) { - echo "fruits[".$key."] = ".$val; +$ovoce = array("citrón", "pomeranè", "banán", "jablko"); +sort($ovoce); +reset($ovoce); +while (list($key, $val) = each($ovoce)) { + echo "ovoce[" . $key . "] = " . $val . "\n"; } -?> +?> +]]> </programlisting> </example> </para> @@ -38,10 +51,12 @@ <para> <informalexample> <programlisting> -fruits[0] = apple -fruits[1] = banana -fruits[2] = lemon -fruits[3] = orange +<![CDATA[ +fruits[0] = banán +fruits[1] = citrón +fruits[2] = jablko +fruits[3] = pomeranè +]]> </programlisting> </informalexample> </para> @@ -66,22 +81,19 @@ </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. + Druhý parametr byl pøidán v PHP 4. </para> </note> + <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> </refsect1> </refentry> Index: phpdoc-cs/reference/strings/functions/explode.xml diff -u phpdoc-cs/reference/strings/functions/explode.xml:1.2 phpdoc-cs/reference/strings/functions/explode.xml:1.3 --- phpdoc-cs/reference/strings/functions/explode.xml:1.2 Sun Jun 9 15:27:27 2002 +++ phpdoc-cs/reference/strings/functions/explode.xml Wed Jan 7 07:44:49 2004 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/strings.xml, last change in rev 1.1 --> -<!-- last change to 'explode' in en/ tree in rev 1.2 --> +<!-- EN-Revision: 1.6 Maintainer: luk Status: ready --> <refentry id="function.explode"> <refnamediv> <refname>explode</refname> @@ -20,7 +19,7 @@ tvoøených øetìzcem <parameter>separator</parameter>. Pokud je definován <parameter>limit</parameter>, vrácené pole bude obsahovat maximálnì <parameter>limit</parameter> prvkù, a poslední prvek bude - obsahovat celý zbytek <parameter>string</parameter>. + obsahovat celý zbytek parametru <parameter>string</parameter>. </para> <note> <para> @@ -30,9 +29,14 @@ v <parameter>string</parameter>, pak <function>explode</function> vrátí pole obsahující celý <parameter>string</parameter>. </para> - + <para> + I kdy¾ <function>implode</function> mù¾e z historických dùvodù pøijímat + argumenty v obou mo¾ných poøadích, <function>explode</function> nemù¾e. + Musíte zajistit, aby byl argument <parameter>separator</parameter> pøed + argumentem <parameter>string</parameter>. + </para> <para> - Argument <parameter>limit</parameter> byl pøidán v PHP 4.0.1 + Parametr <parameter>limit</parameter> byl pøidán v PHP 4.0.1 </para> </note> <para> @@ -40,25 +44,26 @@ <title>Ukázka <function>explode</function></title> <programlisting role="php"> <![CDATA[ -$pizza = "piece1 piece2 piece3 piece4 piece5 piece6"; -$pieces = explode (" ", $pizza); +<?php +// Pøíklad 1 +$pizza = "díl1 díl2 díl3 díl4 díl5 díl6"; +$dily = explode(" ", $pizza); +echo $dily[0]; // díl1 +echo $dily[1]; // díl2 +// Pøíklad 2 $data = "foo:*:1023:1000::/home/foo:/bin/sh"; -list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":",$data); +list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data); +echo $user; // foo +echo $pass; // * + +?> ]]> </programlisting> </example> </para> - <note> - <para> - I kdy¾ <function>implode</function> mù¾e z historických dùvodù pøijímat - argumenty v obou mo¾ných poøadích, <function>explode</function> nemù¾e. - Musíte se ujistit, ¾e je argument <parameter>separator</parameter> pøed - argumentem <parameter>string</parameter>. - </para> - </note> <para> - Viz také: + Viz také <function>preg_split</function>, <function>spliti</function>, <function>split</function> a Index: phpdoc-cs/reference/strings/functions/implode.xml diff -u phpdoc-cs/reference/strings/functions/implode.xml:1.1 phpdoc-cs/reference/strings/functions/implode.xml:1.2 --- phpdoc-cs/reference/strings/functions/implode.xml:1.1 Sun Apr 14 19:48:09 2002 +++ phpdoc-cs/reference/strings/functions/implode.xml Wed Jan 7 07:44:49 2004 @@ -1,6 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./cs/functions/strings.xml, last change in rev 1.1 --> -<!-- last change to 'implode' in en/ tree in rev 1.2 --> +<!-- EN-Revision: 1.10 Maintainer: luk Status: ready --> <refentry id="function.implode"> <refnamediv> <refname>implode</refname> @@ -19,7 +18,16 @@ <example> <title>Ukázka <function>implode</function></title> <programlisting role="php"> -$colon_separated = implode (":", $array); +<![CDATA[ +<?php + +$array = array('pøíjmení', 'e-mail', 'telefon'); +$oddelene_carkami = implode(",", $array); + +echo $oddelene_carkami; // pøíjmení,e-mail,telefon + +?> +]]> </programlisting> </example> </para> @@ -31,10 +39,16 @@ poøadí argumentù. </para> </note> + <note> + <para> + Od PHP 4.3.0 je parametr <parameter>glue</parameter> + volitelný a jeho výchozí hodnota je prázdný øetìzec (''). Toto pou¾ití v¹ak + nedoporuèujeme, pro zaji¹tìní kompatibility se star¹ími verzemi je lep¹í v¾dy + pou¾ívat dva parametry. + </para> + </note> <simpara> - Viz také: <function>explode</function>, - <function>join</function> a - <function>split</function>. + Viz také <function>explode</function> a <function>split</function>. </simpara> </refsect1> </refentry>