cvs: phpdoc-sk /reference/array/functions array.xml each.xml end.xml extract.xml list.xml natcasesort.xml natsort.xml range.xml shuffle.xml sort.xml usort.xml

[email protected] ("Joseph Drake") Mon, 19 Jul 2004 23:57:48 -0000
Newsgroups php.doc.sk
Message-ID <cvsjoseph1090281468@cvsserver>
joseph		Mon Jul 19 19:57:48 2004 EDT

  Modified files:              
    /phpdoc-sk/reference/array/functions	array.xml each.xml end.xml 
                                        	extract.xml list.xml 
                                        	natcasesort.xml natsort.xml 
                                        	range.xml shuffle.xml sort.xml 
                                        	usort.xml 
  Log:
  updated
joseph-20040719195748.txt (text/plain, 18.1 KB)
http://cvs.php.net/diff.php/phpdoc-sk/reference/array/functions/array.xml?r1=1.7&r2=1.8&ty=u
Index: phpdoc-sk/reference/array/functions/array.xml
diff -u phpdoc-sk/reference/array/functions/array.xml:1.7 phpdoc-sk/reference/array/functions/array.xml:1.8
--- phpdoc-sk/reference/array/functions/array.xml:1.7	Wed Feb 11 19:17:07 2004
+++ phpdoc-sk/reference/array/functions/array.xml	Mon Jul 19 19:57:48 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.11 Maintainer: joseph Status: ready -->
+<!-- EN-Revision: 1.12 Maintainer: joseph Status: ready -->
 <!-- splitted from ./en/functions/array.xml, last change in rev 1.110 -->
   <refentry id="function.array">
    <refnamediv>
@@ -37,6 +37,10 @@
      definované dva identické indexy, lebo posledný prepí¹e prvý.
     </para>
     <para>
+     Vleèná èiarka za poslednou definovanou polo¾kou poµa, je platný 
+     syntax, i keï je to nezvyèajné.
+    </para>
+    <para>
      Následujúci príklad demon¹truje ako vytvori» dvoj-dimenzionálne
      pole, ako ¹pecifikova» kµúèe pre asociatívne polia a ako
      preskoèi»-a-pokraèova» èíselné indície v normálnych poliach.
@@ -118,10 +122,28 @@
      </example>
     </para>
     <para>
+     V Perl mô¾ete pristupova» k hodnote z vnútorných dvojitých úvodzoviek
+     poµa. Av¹ak, v PHP budete musie» va¹e pole uzavrie» do zlo¾ených zátvoriek.
+     <example>
+      <title>Pristupovanie k poµu vo vnútri dvojitých úvodzoviek</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+
+$foo = array('bar' => 'baz');
+echo "Hello {$foo['bar']}!"; // Hello baz!
+
+?>
+]]>
+      </programlisting>
+     </example>
+    </para>
+    <para>
      Tie¾ pozri <function>array_pad</function>,
      <function>list</function>,
-     <link linkend="control-structures.foreach">foreach</link>
-     a <function>range</function>.
+     <function>count</function>,
+     <link linkend="control-structures.foreach">foreach</link> a
+     <function>range</function>.
     </para>
    </refsect1>
   </refentry>
http://cvs.php.net/diff.php/phpdoc-sk/reference/array/functions/each.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc-sk/reference/array/functions/each.xml
diff -u phpdoc-sk/reference/array/functions/each.xml:1.4 phpdoc-sk/reference/array/functions/each.xml:1.5
--- phpdoc-sk/reference/array/functions/each.xml:1.4	Wed Feb 11 19:17:07 2004
+++ phpdoc-sk/reference/array/functions/each.xml	Mon Jul 19 19:57:48 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.13 Maintainer: joseph Status: ready -->
+<!-- EN-Revision: 1.14 Maintainer: joseph Status: ready -->
 <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
   <refentry id="function.each">
    <refnamediv>
@@ -18,12 +18,12 @@
      Vracia aktuálny kµúè a pár hodnôt z poµa
      <parameter>pole</parameter> a posúva kurzor poµa. Tento pár sa
      vracia v ¹tvor-prvkovom poli s kµúèami
-     <emphasis>0</emphasis>, <emphasis>1</emphasis>,
-     <emphasis>key</emphasis> a
-     <emphasis>value</emphasis>. Prvky <emphasis>0</emphasis> a
-     <emphasis>key</emphasis> obsahujú kµúèový názov prvku poµa
-     a <emphasis>1</emphasis> a
-     <emphasis>value</emphasis> obsahujú dáta.
+     <literal>0</literal>, <literal>1</literal>,
+     <literal>key</literal> a
+     <literal>value</literal>. Prvky <literal>0</literal> a
+     <literal>key</literal> obsahujú kµúèový názov prvku poµa
+     a <literal>1</literal> a
+     <literal>value</literal> obsahujú dáta.
     </para>
     <para>
      Ak vnútorný ukazovateµ pre pole ukazuje na koniec obsahu poµa,
http://cvs.php.net/diff.php/phpdoc-sk/reference/array/functions/end.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc-sk/reference/array/functions/end.xml
diff -u phpdoc-sk/reference/array/functions/end.xml:1.3 phpdoc-sk/reference/array/functions/end.xml:1.4
--- phpdoc-sk/reference/array/functions/end.xml:1.3	Wed Feb 11 19:17:07 2004
+++ phpdoc-sk/reference/array/functions/end.xml	Mon Jul 19 19:57:48 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.9 Maintainer: joseph Status: ready -->
+<!-- EN-Revision: 1.10 Maintainer: joseph Status: ready -->
 <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
   <refentry id="function.end">
    <refnamediv>
@@ -16,8 +16,7 @@
      </methodsynopsis>
     <para>
      <function>end</function> posúva vnútorný ukazovateµ poµa
-     <parameter>pole</parameter> na posledný prvok a vracia hodnotu
-     z posledného prvku.
+     <parameter>pole</parameter> na posledný prvok a vracia svoju hodnotu.
     </para>
     <para>
      <example>
@@ -26,9 +25,8 @@
 <![CDATA[
 <?php
 
-  $ovocie = array('jablko', 'banan', 'brusnica');
-    
-  echo end($ovocie); // brusnica
+$ovocie = array('jablko', 'banan', 'brusnica');
+echo end($ovocie); // brusnica
       
 ?>
 ]]>
http://cvs.php.net/diff.php/phpdoc-sk/reference/array/functions/extract.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc-sk/reference/array/functions/extract.xml
diff -u phpdoc-sk/reference/array/functions/extract.xml:1.5 phpdoc-sk/reference/array/functions/extract.xml:1.6
--- phpdoc-sk/reference/array/functions/extract.xml:1.5	Wed Feb 11 19:17:07 2004
+++ phpdoc-sk/reference/array/functions/extract.xml	Mon Jul 19 19:57:48 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.14 Maintainer: joseph Status: ready -->
+<!-- EN-Revision: 1.17 Maintainer: joseph Status: ready -->
 <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
   <refentry id="function.extract">
    <refnamediv>
@@ -152,10 +152,10 @@
       Ak tak urobíte, tak napr. ak chcete spusti» starý kód, ktorý sa doèasne
       spolieha na <link linkend="security.registerglobals">register_globals</link>,
       uistite sa, èi pou¾ívate jednu z neprepisujúcich 
-      <parameter>extract_type</parameter> hodnô¾ ako EXTR_SKIP, a pozor na to,
+      <parameter>extract_type</parameter> hodnôt ako EXTR_SKIP, a pozor na to,
       ¾e teraz by ste mali extract-ova» <varname>$_SERVER</varname>, 
       <varname>$_SESSION</varname>, <varname>$_COOKIE</varname>, 
-      <varname>$_POST</varname> a <varname>$_GET</varname> in tom poradí.
+      <varname>$_POST</varname> a <varname>$_GET</varname> v tom poradí.
      </para>
     </warning>
     <para>
http://cvs.php.net/diff.php/phpdoc-sk/reference/array/functions/list.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc-sk/reference/array/functions/list.xml
diff -u phpdoc-sk/reference/array/functions/list.xml:1.3 phpdoc-sk/reference/array/functions/list.xml:1.4
--- phpdoc-sk/reference/array/functions/list.xml:1.3	Wed Feb 11 19:17:07 2004
+++ phpdoc-sk/reference/array/functions/list.xml	Mon Jul 19 19:57:48 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.11 Maintainer: joseph Status: ready -->
+<!-- EN-Revision: 1.12 Maintainer: joseph Status: ready -->
 <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
   <refentry id="function.list">
    <refnamediv>
@@ -12,6 +12,7 @@
     <title>Popis</title>
      <methodsynopsis>
       <type>void</type><methodname>list</methodname>
+      <methodparam><type>mixed</type><parameter>varname</parameter></methodparam>
       <methodparam rep="repeat"><type>mixed</type><parameter>...</parameter></methodparam>
      </methodsynopsis>
     <para>
http://cvs.php.net/diff.php/phpdoc-sk/reference/array/functions/natcasesort.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc-sk/reference/array/functions/natcasesort.xml
diff -u phpdoc-sk/reference/array/functions/natcasesort.xml:1.1 phpdoc-sk/reference/array/functions/natcasesort.xml:1.2
--- phpdoc-sk/reference/array/functions/natcasesort.xml:1.1	Fri Feb 21 18:58:07 2003
+++ phpdoc-sk/reference/array/functions/natcasesort.xml	Mon Jul 19 19:57:48 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.4 Maintainer: joseph Status: ready -->
+<!-- EN-Revision: 1.5 Maintainer: joseph Status: ready -->
 <!-- splitted from ./en/functions/array.xml, last change in rev 1.25 -->
   <refentry id="function.natcasesort">
    <refnamediv>
@@ -15,9 +15,9 @@
       <methodparam><type>array</type><parameter>pole</parameter></methodparam>
      </methodsynopsis>
     <para>
-     Táto funkcia implementuje zoraïovací algoritmus, ktorý
-     zoraïuje alfanumerické re»azce spôsobom, akým by to robil èlovek.
-     Hovorí sa tomu "prirodzené zoraïovanie".
+     Táto funkcia implementuje zoraïovací algoritmus, ktorý zoraïuje 
+     alfanumerické re»azce spôsobom, akým by to robil èlovek zatiaµèo sa
+     zachovajú asociácie kµúè/dodnota. Hovorí sa tomu "prirodzené zoraïovanie".
     </para>
     <para>
      <function>natcasesort</function> je case nesenzitivne verzia
@@ -26,9 +26,57 @@
      uvedený v <function>natsort</function>.
     </para>
     <para>
-     Viac informácií na: stránke <ulink
-     url="&url.strnatcmp;">Re»azcového porovnávania prirodzeného poradia</ulink>
-     Martina Poola.
+     <example>
+      <title><function>natcasesort</function> príklad</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+$array1 = $array2 = array('IMG0.png', 'img12.png', 'img10.png', 'img2.png', 'img1.png', 'IMG3.png');
+
+sort($array1);
+echo "Standardné zoradovanie\n";
+print_r($array1);
+
+natcasesort($array2);
+echo "\nPrirodzene zoradovanie (case-nesenzitivne)\n";
+print_r($array2);
+?>
+]]>
+      </programlisting>
+      <para>
+       Horeuvedený kód vygeneruje následujúci výstup:
+      </para>
+      <screen>
+<![CDATA[
+Standardne zoradovanie
+Array
+(
+    [0] => IMG0.png
+    [1] => IMG3.png
+    [2] => img1.png
+    [3] => img10.png
+    [4] => img12.png
+    [5] => img2.png
+)
+
+Prirodzene zoradovanie (case-nesenzitivne)
+Array
+(
+    [0] => IMG0.png
+    [4] => img1.png
+    [3] => img2.png
+    [5] => IMG3.png
+    [2] => img10.png
+    [1] => img12.png
+)
+]]>
+      </screen>
+      <para>
+       Viac informácii na stránke Martin Pool's <ulink
+       url="&url.strnatcmp;">Re»azcové porovnávanie prirodzeného poradia</ulink>
+       Martina Poola.
+      </para>
+     </example>
     </para>
     <para>
      Tie¾ pozri <function>sort</function>,
http://cvs.php.net/diff.php/phpdoc-sk/reference/array/functions/natsort.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc-sk/reference/array/functions/natsort.xml
diff -u phpdoc-sk/reference/array/functions/natsort.xml:1.4 phpdoc-sk/reference/array/functions/natsort.xml:1.5
--- phpdoc-sk/reference/array/functions/natsort.xml:1.4	Wed Feb 11 19:17:07 2004
+++ phpdoc-sk/reference/array/functions/natsort.xml	Mon Jul 19 19:57:48 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.8 Maintainer: joseph Status: ready -->
+<!-- EN-Revision: 1.9 Maintainer: joseph Status: ready -->
 <!-- splitted from ./en/functions/array.xml, last change in rev 1.25 -->
   <refentry id="function.natsort">
    <refnamediv>
@@ -16,10 +16,10 @@
      </methodsynopsis>
     <para>
      Táto funkcia implementuje zoraïovací algoritmus, ktorý zoraïuje
-     alfanumerické re»azce spôsobom akým by to robil èlovek. Popisuje
-     sa to ako "prirodzené zoradenie". Príklád rozdielu medzi
-     týmto algoritmom a regulernými zoraïovacími algoritmami poèítaèa
-     (pou¾ítých v <function>sort</function>) mô¾ete vidie» ni¾¹ie:
+     alfanumerické re»azce spôsobom akým by to robil èlovek zatiaµèo sa
+     zachovajú asociácie kµúè/hodnota. Popisuje sa to ako "prirodzené zoradenie".
+     Príklád rozdielu medzi týmto algoritmom a regulernými zoraïovacími algoritmami
+      poèítaèa (pou¾ítých v <function>sort</function>) mô¾ete vidie» ni¾¹ie:
     </para>
     <para>
      <example>
@@ -70,12 +70,6 @@
       </para>
      </example>
     </para>
-    <note>
-     <para>
-      Ak chcete ponecha» asociácie index/hodnota, zvá¾te 
-      pou¾itie <literal>usort($arr, 'strnatcmp')</literal>.
-     </para>
-    </note>
     <para>
      Tie¾ pozri <function>natcasesort</function>,
      <function>strnatcmp</function> a
http://cvs.php.net/diff.php/phpdoc-sk/reference/array/functions/range.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc-sk/reference/array/functions/range.xml
diff -u phpdoc-sk/reference/array/functions/range.xml:1.4 phpdoc-sk/reference/array/functions/range.xml:1.5
--- phpdoc-sk/reference/array/functions/range.xml:1.4	Wed Feb 11 19:17:07 2004
+++ phpdoc-sk/reference/array/functions/range.xml	Mon Jul 19 19:57:48 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.13 Maintainer: joseph Status: ready -->
+<!-- EN-Revision: 1.14 Maintainer: joseph Status: ready -->
 <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
   <refentry id="function.range">
    <refnamediv>
@@ -66,7 +66,7 @@
     </para>
     <note>
      <para>
-      Vo verziách star¹ích ne¾ 4.1.0 funkcia <function>range</function>
+      Vo PHP star¹ích ne¾ 4.1.0 funkcia <function>range</function>
       vytvárala iba inkrementujúce celoèíselné polia. Podpora pre
       postupnosti znakov a dekrementácia polí bola pridaná v 4.1.0.
       Hodnoty postupnosti znakov sú limitované na då¾ku jedného. Ak
http://cvs.php.net/diff.php/phpdoc-sk/reference/array/functions/shuffle.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc-sk/reference/array/functions/shuffle.xml
diff -u phpdoc-sk/reference/array/functions/shuffle.xml:1.3 phpdoc-sk/reference/array/functions/shuffle.xml:1.4
--- phpdoc-sk/reference/array/functions/shuffle.xml:1.3	Wed Feb 11 19:17:07 2004
+++ phpdoc-sk/reference/array/functions/shuffle.xml	Mon Jul 19 19:57:48 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.8 Maintainer: novotnyr Status: ready -->
+<!-- EN-Revision: 1.10 Maintainer: novotnyr Status: ready -->
 <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
 <!-- CREDITS: joseph -->
   <refentry id="function.shuffle">
@@ -10,13 +10,11 @@
    <refsect1>
     <title>Popis</title>
      <methodsynopsis>
-      <type>void</type><methodname>shuffle</methodname>
+      <type>bool</type><methodname>shuffle</methodname>
       <methodparam><type>array</type><parameter>pole</parameter></methodparam>
      </methodsynopsis>
     <para>
      Táto funkcia zamie¹a (náhodne zmení poradie prvkov) pole.
-     Pred pou¾itím tejto funkcie musíte zavola» <function>srand</function>
-     na inicializáciu náhodného generátora.
      <example>
       <title>Príklad na <function>shuffle</function></title>
       <programlisting role="php">
http://cvs.php.net/diff.php/phpdoc-sk/reference/array/functions/sort.xml?r1=1.6&r2=1.7&ty=u
Index: phpdoc-sk/reference/array/functions/sort.xml
diff -u phpdoc-sk/reference/array/functions/sort.xml:1.6 phpdoc-sk/reference/array/functions/sort.xml:1.7
--- phpdoc-sk/reference/array/functions/sort.xml:1.6	Wed Feb 11 19:17:07 2004
+++ phpdoc-sk/reference/array/functions/sort.xml	Mon Jul 19 19:57:48 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.10 Maintainer: novotnyr Status: ready -->
+<!-- EN-Revision: 1.12 Maintainer: novotnyr Status: ready -->
 <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
 <!-- CREDITS: joseph -->
   <refentry id="function.sort">
@@ -39,7 +39,7 @@
 sort($fruits);
 reset($fruits);
 while (list($key, $val) = each($fruits)) {
-    echo "fruits[".$key."] = ".$val."\n";
+    echo "fruits[" . $key . "] = " . $val . "\n";
 }
 
 ?>
@@ -69,13 +69,13 @@
      Dostupné príznaky urèujúce spôsob triedenia:
      <itemizedlist>
       <listitem>
-       <simpara>SORT_REGULAR - porovnáva» polo¾ky normálne</simpara>
+       <simpara><constant>SORT_REGULAR</constant> - porovnáva» polo¾ky normálne</simpara>
       </listitem>
       <listitem>
-       <simpara>SORT_NUMERIC - porovnáva» polo¾ky numericky</simpara>
+       <simpara><constant>SORT_NUMERIC</constant> - porovnáva» polo¾ky numericky</simpara>
       </listitem>
       <listitem>
-       <simpara>SORT_STRING - porovnáva» polo¾ky ako re»azce</simpara>
+       <simpara><constant>SORT_STRING</constant> - porovnáva» polo¾ky ako re»azce</simpara>
       </listitem>
      </itemizedlist>
     </para>
@@ -84,6 +84,12 @@
       Druhý parameter bol pridaný v PHP 4.
      </para>
     </note>    
+    <warning>
+     <simpara>
+      Buïte opatrný pri zoraïovaní polí s hodnotami typov mixed, preto¾e
+      <function>sort</function> mô¾e vyrobi» nepredvídateµné výsledky.
+     </simpara>
+    </warning>
     <para>
      Tie¾ pozri <function>arsort</function>,
      <function>asort</function>, <function>ksort</function>,
http://cvs.php.net/diff.php/phpdoc-sk/reference/array/functions/usort.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc-sk/reference/array/functions/usort.xml
diff -u phpdoc-sk/reference/array/functions/usort.xml:1.5 phpdoc-sk/reference/array/functions/usort.xml:1.6
--- phpdoc-sk/reference/array/functions/usort.xml:1.5	Wed Feb 11 19:17:07 2004
+++ phpdoc-sk/reference/array/functions/usort.xml	Mon Jul 19 19:57:48 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.17 Maintainer: joseph Status: ready -->
+<!-- EN-Revision: 1.18 Maintainer: joseph Status: ready -->
 <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
   <refentry id="function.usort">
    <refnamediv>
@@ -93,7 +93,8 @@
       <programlisting role="php">
 <![CDATA[
 <?php
-function cmp($a, $b) {
+function cmp($a, $b)
+{
     return strcmp($a["fruit"], $b["fruit"]);
 }
 
@@ -110,8 +111,8 @@
 ]]>
       </programlisting>
       <para>
-       Pri triedení multi-dimenzionálneho poµa, $a a $b obsahujú
-       odkazy na prvý index poµa.
+       Pri triedení multi-dimenzionálneho poµa, <varname>$a</varname> a
+       <varname>$b</varname> obsahujú odkazy na prvý index poµa.
       </para>
       <para>
        Tento príklad by zobrazil:
@@ -137,13 +138,13 @@
 class TestObj {
     var $name;
 
-    function TestObj($name) 
+    function TestObj($name)
     {
         $this->name = $name;
     }
 
     /* Toto je staticky porovnavajucia funkcia: */
-    function cmp_obj($a, $b) 
+    function cmp_obj($a, $b)
     {
         $al = strtolower($a->name);
         $bl = strtolower($b->name);