Forum und email

uksort

(PHP 4, PHP 5)

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

Descrição

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

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.

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.

Retorna TRUE em caso de sucesso ou FALSE em falhas.

Example#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(), uasort(), sort(), asort(), arsort(), ksort(), natsort() e rsort().