uksort

(PHP 4, PHP 5, PHP 7)

uksortOrdena um array pelas chaves utilizando uma função de comparação definida pelo usuário.

Descrição

uksort ( array &$array , function $cmp_function ) : bool

uksort() irá ordenar as chaves de um array usando uma função de comparação definida pelo usuário. Se o array precisa ser classificado utilizando um critério não trivial, você deve usar essa função.

Parâmetros

array

O array de entrada.

cmp_function

A função callback de comparação.

Função cmp_function deve aceitar dois parâmetros que irão ser preenchidos pelo par de chaves do array. A função de comparação precisa retornar um inteiro menor que, igual a, ou maior que zero se o primeiro argumento é considerado para respectivamente menor que, igual a, ou maior que o segundo.

Valor Retornado

Retorna TRUE em caso de sucesso ou FALSE em caso de falha.

Exemplos

Exemplo #1 Exemplo de uksort()

function cmp($a, $b)
{   
    $a = ereg_replace('^(a|an|the) ', '', $a);
    $b = ereg_replace('^(a|an|the) ', '', $b);
    return strcasecmp($a, $b);
}

$a = array("John" => 1, "the Earth" => 2, "an apple" => 3, "a banana" => 4);

uksort($a, "cmp");

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

O exemplo acima irá imprimir:

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

Veja Também

  • usort() - Ordena um array pelos valores utilizando uma função de comparação definida pelo usuário
  • uasort() - Ordena um array utilizando uma função de comparação definida pelo usuário e mantendo as associações entre chaves e valores
  • sort() - Ordena um array
  • asort() - Ordena um array mantendo a associação entre índices e valores
  • arsort() - Ordena um array em ordem descrescente mantendo a associação entre índices e valores
  • ksort() - Ordena um array pelas chaves
  • natsort() - Ordena um array utilizando o algoritmo da "ordem natural"
  • rsort() - Ordena um array em ordem descrescente