usort

(PHP 3>= 3.0.3, PHP 4 , PHP 5)

usort --  Ordina un array mediante una funzione definita dall'utente

Descrizione

bool usort ( array array, callback cmp_function)

Ordina i valori di un array mediante una funzione di comparazione definita dall'utente. Se si vuole ordinare un array con dei criteri non usuali, si deve usare questa funzione.

La funzione di comparazione deve restituire un intero minore, uguale o superiore a zero se il primo elemento Ŕ da considerarsi rispettivamente minore, uguale o maggiore del secondo.

Nota: Se due parametri vengono valutati come uguali, il loro ordinamento nell'array ordinato Ŕ indefinito. Fino al PHP 4.0.6 le funzioni definite dall'utente mantenevano l'ordine originario per questi elementi, ma con il nuovo algoritmo di ordinamento introdotto con la versione 4.1.0 questo non succede pi¨ dal momento che non c'Ŕ un modo per ottenerlo in maniera efficiente.

Restituisce TRUE in caso di successo, FALSE in caso di fallimento.

Esempio 1. esempio di usort()

<?php
function cmp($a, $b)
{
    if (
$a == $b) {
        return
0;
    }
    return (
$a < $b) ? -1 : 1;
}

$a = array(3, 2, 5, 6, 1);

usort($a, "cmp");

while (list(
$chiave, $valore) = each($a)) {
    echo
"$chiave: $valore\n";
}
?>

Questo esempio mostrerÓ:

0: 1
1: 2
2: 3
3: 5
4: 6

Nota: Ovviamente, in questo caso banale di ordinamento decrescente la funzione sort() sarebbe stata pi¨ appropriata.

Esempio 2. esempio di usort() con un array multidimensionale

<?php
function cmp($a, $b)
{
    return
strcmp($a["frutto"], $b["frutto"]);
}

$frutti[0]["frutto"] = "limoni";
$frutti[1]["frutto"] = "arance";
$frutti[2]["frutto"] = "uva";

usort($frutti, "cmp");

while (list(
$chiave, $valore) = each($frutti)) {
    echo
"\$frutti[$chiave]: " . $valore["frutto"] . "\n";
}
?>

Quando si ordina un array multidimensionale, $a e $b contengono riferimenti al primo indice dell'array.

Questo esempio mostrerÓ:

$frutti[0]: arance
$frutti[1]: limoni
$frutti[2]: uva

Esempio 3. esempio di usort() usando una funzione membro di un oggetto

<?php
class OggettoTest {
    var
$nome;

    function
OggettoTest($nome)
    {
        
$this->nome = $nome;
    }

    
/* Questa Ŕ la funzione statica di comparazione: */
    
function comp_ogg($a, $b)
    {
        
$al = strtolower($a->nome);
        
$bl = strtolower($b->nome);
        if (
$al == $bl) {
            return
0;
        }
        return (
$al > $bl) ? +1 : -1;
    }
}

$a[] = new OggettoTest("c");
$a[] = new OggettoTest("b");
$a[] = new OggettoTest("d");

usort($a, array("OggettoTest", "comp_ogg"));

foreach (
$a as $voce) {
    echo
$voce->nome."\n";
}
?>

Questo esempio mostrerÓ:

b
c
d

Vedere anche uasort(), uksort(), sort(), asort(), arsort(),ksort(), natsort() e rsort().