archived-doc-pl/reference/array/sorting.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79a458220566758cd6abb064de988bebe9246028 Maintainer: sobak Status: ready -->
<chapter xml:id="array.sorting" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Sortowanie tablic</title>
 <para>
  PHP oferuje kilka funkcji sortujących tablice, a ten dokument został stworzony aby pomóc je uporządkować.
 </para>
 <para>
  Główne różnice między funkcjami sortującymi są następujące:
 </para>
 <para>
  <simplelist>
   <member>
    Niektóre sortują po kluczu tablicy, a inne po jej wartości: <literal>$array['klucz'] = 'wartość';</literal>
   </member>
   <member>
    Czy przypisanie klucza do wartości zostaje zachowane, czy też klucze
	są resetowane i tablice otrzymują indeksy numeryczne (0,1,2...)
   </member>
   <member>
    Kolejność sortowania: alfabetyczna, rosnąca, malejąca, numeryczna,
	naturalna, losowa lub określona przez użytkownika
   </member>
   <member>
    Uwaga: wszystkie z funkcji sortujących operują bezpośrednio
	na zmiennej zawierającej tablicę zamiast zwracać nową posortowaną
	tablicę.
   </member>
   <member>
    Jeżeli którakolwiek z tych funkcji określa dwa elementy jako równoznaczne,
	oznacza to że kolejność nie została zdefiniowana (sortowanie nie działa poprawnie).
   </member>
  </simplelist>
 </para>
 <para>
  <table>
   <title>Właściwości funkcji sortujących</title>
   <tgroup cols="5">
    <thead>
     <row>
      <entry>Nazwa funkcji</entry>
      <entry>Sortuje po</entry>
      <entry>Zachowuje przypisanie kluczy</entry>
      <entry>Kolejność sortowania</entry>
      <entry>Powiązane funkcje</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry><function>array_multisort</function></entry>
      <entry>wartości</entry>
      <entry>asocjacyjne tak, numeryczne nie</entry>
      <entry>pierwsza tablica lub opcje sortowania</entry>
      <entry><function>array_walk</function></entry>
     </row>
     <row>
      <entry><function>asort</function></entry>
      <entry>wartości</entry>
      <entry>tak</entry>
      <entry>rosnąco</entry>
      <entry><function>arsort</function></entry>
     </row>
     <row>
      <entry><function>arsort</function></entry>
      <entry>wartości</entry>
      <entry>tak</entry>
      <entry>malejąco</entry>
      <entry><function>asort</function></entry>
     </row>
     <row>
      <entry><function>krsort</function></entry>
      <entry>kluczu</entry>
      <entry>tak</entry>
      <entry>malejąco</entry>
      <entry><function>ksort</function></entry>
     </row>
     <row>
      <entry><function>ksort</function></entry>
      <entry>kluczu</entry>
      <entry>tak</entry>
      <entry>rosnąco</entry>
      <entry><function>asort</function></entry>
     </row>
     <row>
      <entry><function>natcasesort</function></entry>
      <entry>wartości</entry>
      <entry>tak</entry>
      <entry>naturalnie, bez uwzg. wielkości znaków</entry>
      <entry><function>natsort</function></entry>
     </row>
     <row>
      <entry><function>natsort</function></entry>
      <entry>wartości</entry>
      <entry>tak</entry>
      <entry>naturalnie</entry>
      <entry><function>natcasesort</function></entry>
     </row>
     <row>
      <entry><function>rsort</function></entry>
      <entry>wartości</entry>
      <entry>nie</entry>
      <entry>malejąco</entry>
      <entry><function>sort</function></entry>
     </row>
     <row>
      <entry><function>shuffle</function></entry>
      <entry>wartości</entry>
      <entry>nie</entry>
      <entry>losowo</entry>
      <entry><function>array_rand</function></entry>
     </row>
     <row>
      <entry><function>sort</function></entry>
      <entry>wartości</entry>
      <entry>nie</entry>
      <entry>rosnąco</entry>
      <entry><function>rsort</function></entry>
     </row>
     <row>
      <entry><function>uasort</function></entry>
      <entry>wartości</entry>
      <entry>tak</entry>
      <entry>zdefiniowana przez użytkownika</entry>
      <entry><function>uksort</function></entry>
     </row>
     <row>
      <entry><function>uksort</function></entry>
      <entry>kluczu</entry>
      <entry>tak</entry>
      <entry>zdefiniowana przez użytkownika</entry>
      <entry><function>uasort</function></entry>
     </row>
     <row>
      <entry><function>usort</function></entry>
      <entry>wartości</entry>
      <entry>nie</entry>
      <entry>zdefiniowana przez użytkownika</entry>
      <entry><function>uasort</function></entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </para>
</chapter>

<!-- 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:"~/.phpdoc/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
-->