arsort

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

arsortSort an array in descending order and maintain index association

Опис

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

Sorts array in place in descending order, such that its keys maintain their correlation with the values they are associated with.

This is used mainly when sorting associative arrays where the actual element order is significant.

Зауваження:

Якщо два члени порівняння однакові, їхній порядок зберігається. До PHP 8.0.0, їхній відносний порядок у впорядкованому масиві був невизначеним.

Зауваження:

Скидає внутрішній вказівник масиву на перший елемент.

Параметри

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.

Журнал змін

Версія Опис
8.2.0 Тепер повертається значення типу true. До цього був bool.

Приклади

Приклад #1 arsort() example

<?php
$fruits
= array("d" => "lemon", "a" => "orange", "b" => "banana", "c" => "apple");
arsort($fruits);
foreach (
$fruits as $key => $val) {
echo
"$key = $val\n";
}
?>

Поданий вище приклад виведе:

a = orange
d = lemon
b = banana
c = apple

The fruits have been sorted in reverse alphabetical order, and the index associated with each element has been maintained.

Прогляньте також