ArrayObject::uksort

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

ArrayObject::uksort — Ordena as entradas pelas chaves usando uma função de comparação definida pelo usuário

Descrição

public ArrayObject::uksort(callable $callback): true

Esta função ordena as chaves das entradas usando uma função de comparação fornecida pelo usuário. A correlação chave-entrada será mantida.

Nota:
Se dois elementos são comparados como iguais, eles mantêm sua ordem original. Antes do PHP 8.0.0, sua ordem relativa no array ordenado era indefinida.

Parâmetros

callback: A função de comparação deve retornar um inteiro menor que, igual ou maior que zero se o primeiro argumento for considerado respectivamente menor que, igual ou maior que o segundo.

callback(mixed $a, mixed $b): int

Cuidado
Retornar valores não inteiros da função de comparação, como float, resultará em uma conversão interna do valor retornado da função callback para int. Portanto, valores como 0.99 e 0.1 serão convertidos para o valor inteiro 0, o que comparará esses valores como iguais.

Valor Retornado

Sempre retorna true.

Registro de Alterações

Versão	Descrição
8.2.0	O tipo do retorno agora é `true`; anteriormente, era bool.

Exemplos

Exemplo #1 Exemplo de ArrayObject::uksort()

<?php
function cmp($a, $b) {
    $a = preg_replace('@^(a|an|the) @', '', $a);
    $b = preg_replace('@^(a|an|the) @', '', $b);
    return strcasecmp($a, $b);
}

$array = array("John" => 1, "the Earth" => 2, "an apple" => 3, "a banana" => 4);
$arrayObject = new ArrayObject($array);
$arrayObject->uksort('cmp');

foreach ($arrayObject as $key => $value) {
    echo "$key: $value\n";
}
?>

O exemplo acima produzirá:

an apple: 3
a banana: 4
the Earth: 2
John: 1

Veja Também

ArrayObject::asort() - Ordenar as entradas por valor
ArrayObject::ksort() - Ordena as entradas pela chave
ArrayObject::natsort() - Ordena as entradas usando um algoritmo de "ordem natural"
ArrayObject::natcasesort() - Ordena uma matriz usando um algoritmo de "ordem natural" insensível a maiúsculas e minúsculas
ArrayObject::uasort() - Ordena as entradas com uma função de comparação definida pelo usuário e mantém a associação de chaves
uksort() - Ordena um array pelas chaves utilizando uma função de comparação definida pelo usuário.

add a note

User Contributed Notes

There are no user contributed notes for this page.