Uksort: примеры (PHP)

Примеры использования uksort

Сортировка по длине ключа:

$array = ['яблоко' => 1, 'апельсин' => 2, 'груша' => 3];
uksort($array, function($a, $b) {
    return strlen($a) <=> strlen($b);
});
print_r($array);

Array
(
    [груша] => 3
    [яблоко] => 1
    [апельсин] => 2
)

$array = ['10' => 'десять', '2' => 'два', '1' => 'один'];
uksort($array, 'strnatcmp');
print_r($array);

Array
(
    [1] => один
    [2] => два
    [10] => десять
)

Похожие функции в PHP

Стандартные функции для сортировки по ключам в возрастающем и убывающем порядке. Используют естественный порядок сортировки и не требуют функции сравнения.

Сортируют массив по значениям с пользовательской функцией. usort не сохраняет ключи, uasort сохраняет ассоциацию ключ-значение.

uksort применяют при нестандартных ключах или сложных правилах сравнения. Для простой сортировки подходят ksort/krsort. Если нужно сортировать по значениям - usort/uasort.

Типичные ошибки

Функция сравнения должна возвращать целое число:

$array = ['a' => 1, 'b' => 2];
uksort($array, function($a, $b) {
    return $a <=> $b; // Правильно
    // return ($a < $b) ? -1 : 1; // Неправильно для равных значений
});

Не рекомендуется изменять сортируемый массив внутри функции сравнения:

$array = ['a' => 1, 'b' => 2];
uksort($array, function($a, $b) use (&$array) {
    unset($array['a']); // Непредсказуемое поведение
    return strcmp($a, $b);
});

Изменения в версиях PHP

В PHP 8.0.0 функция теперь выбрасывает TypeError, если параметр callback не является допустимым callback. Ранее возвращала false и вызывала ошибку уровня E_WARNING.

// PHP 7
uksort($array, 'несуществующая_функция'); // Warning
// PHP 8
uksort($array, 'несуществующая_функция'); // TypeError

С PHP 8.0.0 поддерживаются стрелочные функции для более краткой записи:

uksort($array, fn($a, $b) => strlen($a) <=> strlen($b));

Расширенные примеры

$products = [
    'product_10' => 'Стол',
    'product_2' => 'Стул',
    'item_5' => 'Лампа'
];

uksort($products, function($a, $b) {
    list($aType, $aId) = explode('_', $a);
    list($bType, $bId) = explode('_', $b);
    
    // Сначала по типу, потом по ID
    if ($aType !== $bType) {
        return strcmp($aType, $bType);
    }
    return $aId <=> $bId;
});

print_r($products);

Array
(
    [item_5] => Лампа
    [product_2] => Стул
    [product_10] => Стол
)

$events = [
    '2023-12-25' => 'Рождество',
    '2023-01-01' => 'Новый год',
    '2023-06-01' => 'День защиты детей'
];

uksort($events, function($a, $b) {
    return strtotime($a) <=> strtotime($b);
});

print_r($events);

Array
(
    [2023-01-01] => Новый год
    [2023-06-01] => День защиты детей
    [2023-12-25] => Рождество
)

Аналоги в других языках

Uksort в Python

Используют метод sorted() с key или cmp:

dictionary = {'яблоко': 1, 'апельсин': 2, 'груша': 3}
sorted_dict = dict(sorted(dictionary.items(), 
                       key=lambda item: len(item[0])))
print(sorted_dict)

{'груша': 3, 'яблоко': 1, 'апельсин': 2}

Uksort в Javascript

Объекты в JS не гарантируют порядок ключей, но можно использовать Map:

const map = new Map([
  ['яблоко', 1],
  ['апельсин', 2],
  ['груша', 3]
]);
const sorted = new Map([...map].sort(
  (a, b) => a[0].length - b[0].length
));
console.log(Object.fromEntries(sorted));

{ груша: 3, яблоко: 1, апельсин: 2 }