cvs: phpdoc-sk /reference/array/functions array-multisort.xml array-pad.xml array-pop.xml array-push.xml array-rand.xml

Index: phpdoc-sk/reference/array/functions/array-multisort.xml
+++ phpdoc-sk/reference/array/functions/array-multisort.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.4 Maintainer: joseph Status: ready -->
<!-- splitted from ./en/functions/array.xml, last change in rev 1.11 -->
  <refentry id="function.array-multisort">
   <refnamediv>
    <refname>array_multisort</refname>
    <refpurpose>Triedi» viac polí alebo multi-dimenzionálne polia</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>bool</type><methodname>array_multisort</methodname>
      <methodparam><type>array</type><parameter>ar1</parameter></methodparam>
      <methodparam choice="opt"><type>mixed</type><parameter>arg</parameter></methodparam>
      <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
      <methodparam choice="opt"><type>array</type><parameter>...</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>array_multisort</function> sa mô¾e pou¾i» na triedenie
     niekoµkých polí naraz alebo multi-dimenzionálne pole podµa jednej
     z viacerých dimenzií. Pri triedení sa zachováva asociácia kµúèov.
    </para>
    <para>
     Vstupné polia sa spracujú ako ståpce tabuµky, ktorá sa má triedi»
     podµa riadkov - toto sa podobá klauzule SQL ORDER BY. Prvé
     pole je primárne, podµa ktorého sa zoraïuje. Riadky (hodnoty)
     v tom poli, ktoré porovnávajú rovnako, sa triedia podµa
     ïal¹ieho vstupného poµa atï.
    </para>
    <para>
     ©truktúra argumentu tejto funkcie je mierne nezvyèajná, ale
     flexibilná. Úplne prvý argument musí by» pole. Následne,
     ka¾dý argument mô¾e by» buï pole alebo triediaca náves»
     z následujúcich zoznamov.
    </para>
    <para>
     Návesti smeru zoradenia:
     <itemizedlist>
      <listitem>
       <simpara>SORT_ASC - zoradi» vzostupne</simpara>
      </listitem>
      <listitem>
       <simpara>SORT_DESC - zoradi» zostupne</simpara>
      </listitem>
     </itemizedlist>
    </para>
    <para>
     Návesti typov zoradenia:
     <itemizedlist>
      <listitem>
       <simpara>SORT_REGULAR - porovnáva» polo¾ky normálne</simpara>
      </listitem>
      <listitem>
       <simpara>SORT_NUMERIC - porovnáva» polo¾ky èíselné</simpara>
      </listitem>
      <listitem>
       <simpara>SORT_STRING - porovnáva» polo¾ky ako re»azce</simpara>
      </listitem>
     </itemizedlist>
    </para>
    <para>
     Po ka¾dom poli mô¾te ¹pecifikova» jednu náves» ka¾dého typu.
     Trediace návesti ¹pecifikované po argumente poµa sa aplikujú
     iba na toto pole - po ka¾dom novom argumente poµa sa resetujú
     na defaultné ORT_ASC a SORT_REGULAR.
    </para>
    <para>
     &return.success;
    </para>
    <para>
     <example>
      <title>Triedenie viacerých polí</title>
      <programlisting role="php">
<![CDATA[
$ar1 = array ("10", 100, 100, "a");
$ar2 = array (1, 3, "2", 1);
array_multisort ($ar1, $ar2);
]]>
      </programlisting>
     </example>
    </para>
    <para>
     V tomto príklade bude po zotriedení prvé pole obsahova» 10,
     "a", 100, 100. Druhé pole bude obsahova» 1, 1, "2", 3.
     Polo¾ky v druhom poli zodpovedajúce identickým polo¾kám
     v prvom poli (100 a 100) boli tie¾ zotriedené.
    </para>
    <para>
     <example>
      <title>Triedenie multi-dimenzionálneho poµa</title>
      <programlisting role="php">
<![CDATA[
$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 tomto príklade bude po zotriedení prvé pole obsahova» 10,
     100, 100, "a" (bolo zotriedené ako re»azce v vzostupnom poradí) a
     druhé bude obsahova» 1, 3, "2", 1 (zoradené ako èísla
     v zostupnom poradí).
    </para>
   </refsect1>
  </refentry>

<!-- 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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

Index: phpdoc-sk/reference/array/functions/array-pad.xml
+++ phpdoc-sk/reference/array/functions/array-pad.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.4 Maintainer: joseph Status: ready -->
<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
  <refentry id="function.array-pad">
   <refnamediv>
    <refname>array_pad</refname>
    <refpurpose>
     Doplni» pole hodnotou urèenej då¾ky
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>array</type><methodname>array_pad</methodname>
      <methodparam><type>array</type><parameter>input</parameter></methodparam>
      <methodparam><type>int</type><parameter>pad_size</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>pad_value</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>array_pad</function> vracia kópiu poµa
     <parameter>input</parameter> doplnenú na veµkos»
     <parameter>pad_size</parameter> hodnotou
     <parameter>pad_value</parameter>. Ak
     je <parameter>pad_size</parameter> pozitíva, pole sa doplní
     z prava, ak je negatívna, tak z µava. Ak je absolutna hodnota
     <parameter>pad_size</parameter> men¹ia alebo rovná
     då¾ke <parameter>input</parameter>, tak sa
     ¾iadne doplnenie nevykoná.
    </para>
    <para>
     <example>
      <title><function>array_pad</function> príklad</title>
      <programlisting role="php">
<![CDATA[
$vstup = array (12, 10, 9);

$vysledok = array_pad ($vstup, 5, 0);
// vysledkom je pole (12, 10, 9, 0, 0)

$vysledok = array_pad ($vstup, -7, -1);
// vysledkom je pole (-1, -1, -1, -1, 12, 10, 9)

$vysledok = array_pad ($vstup, 2, "noop");
// nerozsirene
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

<!-- 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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

Index: phpdoc-sk/reference/array/functions/array-pop.xml
+++ phpdoc-sk/reference/array/functions/array-pop.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.4 Maintainer: joseph Status: ready -->
<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
  <refentry id="function.array-pop">
   <refnamediv>
    <refname>array_pop</refname>
    <refpurpose>Odstráni» prvok z konca poµa</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>mixed</type><methodname>array_pop</methodname>
      <methodparam><type>array</type><parameter>pole</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>array_pop</function> odstráni a vráti poslednú hodnotu
     z <parameter>pole</parameter>, èím
     <parameter>pole</parameter> skráti o jeden prvok.
     Ak je <parameter>pole</parameter> prázdne (alebo nie je poµom),
     vráti sa &null;.
    </para>
    <para>
     <example>
      <title><function>array_pop</function> príklad</title>
      <programlisting role="php">
<![CDATA[
$kopa = array ("pomaranc", "banan", "jablko", "malina");
$ovocie = array_pop ($kopa);
]]>
      </programlisting>
      <para>
       Po tomto, <varname>$kopa</varname> bude ma» iba 3 prvky:
       <screen role="php">
<![CDATA[
Array
(
    [0] => pomaranc
    [1] => banan
    [2] => jablko
)
]]>
       </screen>
       a <literal>malina</literal> bude priradena k
       <varname>$ovocie</varname>.
      </para>
     </example>
    </para>
    &return.falseproblem;
    <para>
     Tie¾ pozri <function>array_push</function>,
     <function>array_shift</function>, a
     <function>array_unshift</function>.
    </para>
   </refsect1>
  </refentry>

<!-- 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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

Index: phpdoc-sk/reference/array/functions/array-push.xml
+++ phpdoc-sk/reference/array/functions/array-push.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.4 Maintainer: joseph Status: ready -->
<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
  <refentry id="function.array-push">
   <refnamediv>
    <refname>array_push</refname>
    <refpurpose>
     Posunú» jeden alebo viacero prvkov na koniec poµa
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>array_push</methodname>
      <methodparam><type>array</type><parameter>pole</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>prem</parameter></methodparam>
      <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>array_push</function> spracúva
     <parameter>pole</parameter> ako kopu a posúva premenné na
     koniec <parameter>pole</parameter>.
     Då¾ka <parameter>pole</parameter> sa zväè¹uje o poèet
     posunutých premenných. Má rovnaký efekt ako:
     <programlisting role="php">
<![CDATA[
$array[] = $var;
]]>
     </programlisting>
     opakované pre ka¾dú <parameter>var</parameter>.
    </para>
    <para>
     Vracia nový poèet prvkov v poli.
    </para>
    <para>
     <example>
      <title><function>array_push</function> príklad</title>
      <programlisting role="php">
<![CDATA[
$kopa = array ("pomaranc", "banan");
array_push ($kopa, "jablko", "malina");
]]>
      </programlisting>
      <para>
       V tomto príklade by mala <varname>$kopa</varname> ma»
       následujúce prvky:
       <screen role="php">
<![CDATA[
Array
(
    [0] => pomaranc
    [1] => banan
    [2] => jablko
    [3] => malina
)
]]>
       </screen>
      </para>
     </example>
    </para>
    <para>
     Tie¾ pozri <function>array_pop</function>,
     <function>array_shift</function> a
     <function>array_unshift</function>.
    </para>
   </refsect1>
  </refentry>

<!-- 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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

Index: phpdoc-sk/reference/array/functions/array-rand.xml
+++ phpdoc-sk/reference/array/functions/array-rand.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.4 Maintainer: joseph Status: ready -->
<!-- splitted from ./en/functions/array.xml, last change in rev 1.13 -->
  <refentry id="function.array-rand">
   <refnamediv>
    <refname>array_rand</refname>
    <refpurpose>
     Vybra» jednu alebo viacero náhodných polo¾iek z poµa
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>mixed</type><methodname>array_rand</methodname>
      <methodparam><type>array</type><parameter>vstup</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>num_req</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>array_rand</function> je celkom u¾itoèná, keï chcete
     vybra» jednu alebo viacero polo¾iek z poµa. Prijíma pole
     <parameter>vstup</parameter> a voliteµný argument
     <parameter>num_req</parameter>, ktorý ¹pecifikuje koµko polo¾iek
     chcete vybra» - ak nie je ¹pecifikovaný, default je 1.
    </para>
    <para>
     Ak vyberáte iba jednu polo¾ku, <function>array_rand</function>
     vracia klúè pre náhodnú polo¾ku. Inak vracia pole kµúèov pre
     náhodné polo¾ky. To sa urobí tak, ¾e z poµa nemusíte vybra» len
     náhodné kµúèe, ale aj hodnoty.
    </para>
    <para>
     Nezabudnite zavola» <function>srand</function> pre inicializáciu
     generátora náhodných èísiel.
    </para>
    <para>
     <example>
      <title><function>array_rand</function> príklad</title>
      <programlisting role="php">
<![CDATA[
srand ((float) microtime() * 10000000);
$vstup = array ("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
$nahod_kluce = array_rand ($vstup, 2);
print $vstup[$nahod_kluce[0]]."\n";
print $vstup[$nahod_kluce[1]]."\n";
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

<!-- 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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->