array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.ksort.php', 1 => 'ksort', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Функции для работы с массивами', ), 'prev' => array ( 0 => 'function.krsort.php', 1 => 'krsort', ), 'next' => array ( 0 => 'function.list.php', 1 => 'list', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/array/functions/ksort.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
ksort — Сортирует массив по ключу в порядке возрастания
Сортирует 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
.
Пример #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" }