array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.sort.php', 1 => 'sort', 2 => 'Сортирует массив по возрастанию', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Функции для работы с массивами', ), 'prev' => array ( 0 => 'function.sizeof.php', 1 => 'sizeof', ), 'next' => array ( 0 => 'function.uasort.php', 1 => 'uasort', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/array/functions/sort.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

sort

(PHP 4, PHP 5, PHP 7, PHP 8)

sort — Сортирует массив по возрастанию

Описание

sort(array &$array, int $flags = SORT_REGULAR): true

Функция сортирует массив array на месте по значениям в порядке возрастания.

Замечание:

Функция сохраняет первоначальный порядок элементов, если при сравнении значения двух элементов равны. До PHP 8.0.0 взаимный порядок одинаковых по значению элементов в отсортированном массиве оставался неопределённым.

Замечание: Функция присваивает новые ключи элементам массива, который передали в аргументе array. Функция удалит, а не просто переупорядочит ключи входного массива.

Замечание:

Функция сбрасывает внутренний указатель массива на первый элемент.

Список параметров

array

Входной массив.

flags

Необязательный второй параметр flags изменяет поведение сортировки и принимает следующие значения:

Флаги типов сортировки:

  • SORT_REGULAR — обычное сравнение элементов; подробности описаны в разделе операторы сравнения
  • SORT_NUMERIC — числовое сравнение элементов
  • SORT_STRING — строковое сравнение элементов
  • SORT_LOCALE_STRING — сравнение элементов как строк на основе текущего языкового стандарта. Флаг использует языковой стандарт, который доступен для изменения4 функцией setlocale()
  • SORT_NATURAL — сравнение элементов как строк на основе «естественного порядка» наподобие natsort()
  • SORT_FLAG_CASE — флаг объединяют через побитовое ИЛИ с флагом SORT_STRING или SORT_NATURAL для сортировки строк без учёта регистра

Возвращаемые значения

Функция возвращает логическое значение true.

Список изменений

Версия Описание
8.2.0 Значение возврата теперь принадлежит типу true; раньше значение принадлежало типу bool.

Примеры

Пример #1 Пример сортировки массива по возрастанию функцией sort()

<?php

$fruits = array("lemon", "orange", "banana", "apple");

sort($fruits);

foreach ($fruits as $key => $val) {
echo "fruits[" . $key . "] = " . $val . "\n";
}

?>

Результат выполнения приведённого примера: 

fruits[0] = apple
fruits[1] = banana
fruits[2] = lemon
fruits[3] = orange

Функция отсортировалв фрукты в алфавитном порядке.

Пример #2 Пример сортировки массива функцией sort() с регистронезависимым естественным упорядочением

<?php

$fruits = array(
"Orange1", "orange2", "Orange3", "orange20"
);

sort($fruits, SORT_NATURAL | SORT_FLAG_CASE);

foreach ($fruits as $key => $val) {
echo "fruits[" . $key . "] = " . $val . "\n";
}

?>

Результат выполнения приведённого примера: 

fruits[0] = Orange1
fruits[1] = orange2
fruits[2] = Orange3
fruits[3] = orange20

Функция отсортировала фрукты аналогично функции natcasesort().

Примечания

Замечание: Как и бóльшая часть функций сортировки в PHP, функция sort() сортирует элементы массива алгоритмом » быстрой сортировки. Опорный элемент выбирается из середины сортируемой части, чтобы обработать уже отсортированный массив за оптимальное время. Лучше не полагаются на эту информацию, поскольку это только деталь реализации.

Внимание

Массивы с разнотипными элементами сортируют осторожно, поскольку при установке флага SORT_REGULAR для параметра flags функции sort() иногда возвращает неожиданные результаты.

Смотрите также