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

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d1df62fe77b6cb0676d064e8e63ee2c3304d4260 Maintainer: sobak Status: ready -->
<!-- CREDITS: grzesiek -->
<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 (od najniższej do najwyższej),
    malejąca (od najwyższej do najniższej), naturalna, losowa lub zdefiniowana 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śli którakolwiek z tych funkcji sortowania oceni dwa elementy jako równe,
    zachowują one swoją pierwotną kolejność.
    Przed PHP 8.0.0 ich kolejność była niezdefiniowana (sortowanie nie było stabilne).
   </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><type>string</type> klucze tak, <type>int</type> klucze 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>krsort</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
-->