(PHP 3>= 3.0.3, PHP 4 )
usort -- Ordena um array pelos valores utilizando uma função de comparação definida pelo usuárioEssa função irá ordenar um array pelos valores usando uma função de classificação definida pelo usuário. Se o array precisar ser ordenado utilizando um critério não trivial, você deve usar essa função.
A função de comparação deve retornar um inteiro menor, igual ou maior que zero se o primeiro argumento for considerado respectivamente menor, igual, ou maior que o segundo.
Nota: Se dois elementos são considerados iguais, a ordem deles fica indefinida no array resultante. Até o PHP 4.0.6 as funções definidas pelo usuário manteriam a ordem original desses elementos, mas com o novo algoritmo de ordenação introduzido no 4.1.0 esse não é o caso, pois não existe solução para fazer isso de modo eficiente.
Esse exemplo mostraria:
Nota: Obviamente que nesse caso trivial a função rsort() seria mais apropriada.
Na ordenação de um array multi-dimensional, $a e $b contêm referências para o primeiro índice do array.
Esse exemplo mostraria:
$fruits[0]: abacaxis $fruits[1]: goiabas $fruits[2]: limoes |
Nota: Ao invés de um nome de função, um array contendo uma referência de objeto e ao nome de método também pode ser fornecidos.
Exemplo 3. Exemplo de usort() usando uma função membro de um objeto
|
Esse exemplo mostraria:
b c d |
Veja também uasort(), uksort(), sort(), asort(), arsort(),ksort(), natsort(), e rsort().