(PHP 4, PHP 5, PHP 7, PHP 8)
sort — Sort an array in ascending order
Sorts array
in place by values
in ascending order.
Зауваження:
Якщо два члени порівняння однакові, їхній порядок зберігається. До PHP 8.0.0, їхній відносний порядок у впорядкованому масиві був невизначеним.
Зауваження: Ця функція призначає нові ключі для елементів в масиві
array
. Вона видаляє будь-які наявні ключі, а не просто перевпорядковує їх.
Зауваження:
Скидає внутрішній вказівник масиву на перший елемент.
array
The input array.
flags
Необов'язковий другий параметр flags
можна
використовувати для зміни способу впорядкування, вказавши значення:
Прапорці типу впорядкування:
SORT_REGULAR
— звичайне порівняння
елементів. Докладніше у розділі Оператори
порівняння
SORT_NUMERIC
— числове порівняння
елементів
SORT_STRING
— рядкове порівняння
елементів
SORT_LOCALE_STRING
— рядкове порівняння елементів,
відповідно до поточної локалізації. Використовується локалізація, котру
можна змінити за допомогою setlocale()
SORT_NATURAL
— "природнє" рядкове порівняння, як у
natsort()
SORT_FLAG_CASE
— можна поєднати (побітове АБО) з
SORT_STRING
або SORT_NATURAL
для впорядкування рядків без урахування регістру
Завжди повертає true
.
Приклад #1 sort() example
<?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
The fruits have been sorted in alphabetical order.
Приклад #2 sort() example using case-insensitive natural ordering
<?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
The fruits have been sorted like natcasesort().
Зауваження: Like most PHP sorting functions, sort() uses an implementation of » Quicksort. The pivot is chosen in the middle of the partition resulting in an optimal time for already sorted arrays. This is however an implementation detail you shouldn't rely on.
Be careful when sorting arrays with mixed types values because
sort() can produce unexpected results,
if flags
is SORT_REGULAR
.