(PHP 4, PHP 5, PHP 7, PHP 8)
ksort — Сортирует массив по ключу в порядке возрастания
&$array
, int $flags
= SORT_REGULAR
): true
Сортирует array
по ключу в порядке возрастания.
Замечание:
Если оба сравниваемых значения эквивалентны, они сохраняют свой первоначальный порядок. До PHP 8.0.0 их относительный порядок в отсортированном массиве не был определён.
Замечание:
Сбрасывает внутренний указатель массива на первый элемент.
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 Пример использования ksort()
<?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() с числовыми (int) ключами
<?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" }