ksort

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

ksortSort an array by key in ascending order

Опис

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

Sorts array in place by keys in ascending order.

Зауваження:

Якщо два члени порівняння однакові, їхній порядок зберігається. До 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.
8.2.0 This function now does numeric string comparison under SORT_REGULAR using the standard PHP 8 rules.

Приклади

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

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

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

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

Приклад #2 ksort() with int keys

<?php
$a
= [0 => 'First', 2 => 'Last', 1 => 'Middle'];
var_dump($a);
ksort($a);
var_dump($a);
?>

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

array(3) {
  [0]=>
  string(5) "First"
  [2]=>
  string(4) "Last"
  [1]=>
  string(6) "Middle"
}
array(3) {
  [0]=>
  string(5) "First"
  [1]=>
  string(6) "Middle"
  [2]=>
  string(4) "Last"
}

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