(PHP 4, PHP 5, PHP 7, PHP 8)
sort — Сортирует массив по возрастанию
Сортирует array по значению в порядке возрастания.
Замечание:
Функция сохраняет первоначальный порядок элементов, если при сравнении значения двух элементов равны. До PHP 8.0.0 порядок элементов в отсортированном массиве оставался неопределённым.
Замечание: Функция присваивает новые ключи элементам массива, который передали в аргументе
array. Функция удалит, а не просто переупорядочит ключи входного массива.
Замечание:
Функция сбрасывает внутренний указатель массива на первый элемент.
arrayВходной массив.
flags
Необязательный второй параметр flags изменяет поведение сортировки и принимает следующие значения:
Флаги типов сортировки:
SORT_REGULAR — обычное сравнение элементов;
подробности описаны в разделе операторы сравнения
SORT_NUMERIC — числовое сравнение элементов
SORT_STRING — строковое сравнение элементов
SORT_LOCALE_STRING — сравнение элементов как
строк на основе текущего языкового стандарта. Флаг использует языковой стандарт,
который можно изменить функцией 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()
может быть неожиданным, если параметр flags равен SORT_REGULAR.