<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.array.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'array.sorting.php',
    1 => 'Сортировка массивов',
    2 => 'Сортировка массивов',
  ),
  'up' => 
  array (
    0 => 'book.array.php',
    1 => 'Массивы',
  ),
  'prev' => 
  array (
    0 => 'array.constants.php',
    1 => 'Предопределённые константы',
  ),
  'next' => 
  array (
    0 => 'ref.array.php',
    1 => 'Функции для работы с массивами',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/array/sorting.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="array.sorting" class="chapter">
 <h1 class="title">Сортировка массивов</h1>

 <p class="para">
  В PHP есть несколько функций для сортировки массивов, на этой странице
  даётся их общее описание.
 </p>
 <p class="para">
  Основные различия между функциями:
 </p>
 <p class="para">
  <ul class="simplelist">
   <li>
    В одних функциях массивы (<span class="type"><a href="language.types.array.php" class="type array">array</a></span>) сортируются по ключам
    элементов, в других по значениям:
    <code class="literal">$array[&#039;ключ&#039;] = &#039;значение&#039;;</code>
   </li>
   <li>
    В каких-то функциях связь между ключами и значениями после сортировки
    сохраняется, в каких-то нет. Это может приводить к тому, что ключи будут
    сбрасываться в числовые значения (0, 1, 2, ...).
   </li>
   <li>
    Различия в порядке сортировки: алфавитный, возрастающий, убывающий,
    числовой, естественный, случайный или определённый пользователем
   </li>
   <li>
    Примечание: Все функции сортировки модифицируют переданный массив, а не
    возвращают отсортированную копию
   </li>
   <li>
    Если какая-либо из этих функций сортировки оценивает два элемента как равные, они сохраняют свой исходный порядок.
    До PHP 8.0.0 их порядок не был определён (сортировка была нестабильной).
   </li>
  </ul>
 </p>
 <p class="para">
  <table class="doctable table">
   <caption><strong>Свойства функций сортировки</strong></caption>
   
    <thead>
     <tr>
      <th>Имя функции</th>
      <th>Сортирует по</th>
      <th>Сохраняет связь ключ - значение</th>
      <th>Порядок сортировки</th>
      <th>Похожие функции</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><span class="function"><a href="function.array-multisort.php" class="function">array_multisort()</a></span></td>
      <td>значению</td>
      <td>строковые (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>) ключи да, числовые (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>) - нет</td>
      <td>первый массив или настройки сортировки</td>
      <td><span class="function"><a href="function.array-walk.php" class="function">array_walk()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.asort.php" class="function">asort()</a></span></td>
      <td>значению</td>
      <td>да</td>
      <td>по возрастанию</td>
      <td><span class="function"><a href="function.arsort.php" class="function">arsort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.arsort.php" class="function">arsort()</a></span></td>
      <td>значению</td>
      <td>да</td>
      <td>по убыванию</td>
      <td><span class="function"><a href="function.asort.php" class="function">asort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.krsort.php" class="function">krsort()</a></span></td>
      <td>ключу</td>
      <td>да</td>
      <td>по убыванию</td>
      <td><span class="function"><a href="function.ksort.php" class="function">ksort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.ksort.php" class="function">ksort()</a></span></td>
      <td>ключу</td>
      <td>да</td>
      <td>по возрастанию</td>
      <td><span class="function"><a href="function.krsort.php" class="function">krsort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.natcasesort.php" class="function">natcasesort()</a></span></td>
      <td>значению</td>
      <td>да</td>
      <td>естественный, нечувствительный к регистру</td>
      <td><span class="function"><a href="function.natsort.php" class="function">natsort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.natsort.php" class="function">natsort()</a></span></td>
      <td>значению</td>
      <td>да</td>
      <td>естественный</td>
      <td><span class="function"><a href="function.natcasesort.php" class="function">natcasesort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.rsort.php" class="function">rsort()</a></span></td>
      <td>значению</td>
      <td>нет</td>
      <td>по убыванию</td>
      <td><span class="function"><a href="function.sort.php" class="function">sort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.shuffle.php" class="function">shuffle()</a></span></td>
      <td>значению</td>
      <td>нет</td>
      <td>случайный</td>
      <td><span class="function"><a href="function.array-rand.php" class="function">array_rand()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.sort.php" class="function">sort()</a></span></td>
      <td>значению</td>
      <td>нет</td>
      <td>по возрастанию</td>
      <td><span class="function"><a href="function.rsort.php" class="function">rsort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.uasort.php" class="function">uasort()</a></span></td>
      <td>значению</td>
      <td>да</td>
      <td>определяется пользователем</td>
      <td><span class="function"><a href="function.uksort.php" class="function">uksort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.uksort.php" class="function">uksort()</a></span></td>
      <td>ключу</td>
      <td>да</td>
      <td>определяется пользователем</td>
      <td><span class="function"><a href="function.uasort.php" class="function">uasort()</a></span></td>
     </tr>

     <tr>
      <td><span class="function"><a href="function.usort.php" class="function">usort()</a></span></td>
      <td>значению</td>
      <td>нет</td>
      <td>определяется пользователем</td>
      <td><span class="function"><a href="function.uasort.php" class="function">uasort()</a></span></td>
     </tr>

    </tbody>
   
  </table>

 </p>
</div>
<?php manual_footer($setup); ?>