uksort

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

uksort --  ユーザー定義の比較関数を用いてキーで配列をソートします

説明

bool uksort ( array &array, callback cmp_function )

uksort() は、 ユーザー定義の比較関数を用いて配列のキーをソートします。 ソートしたい配列を複雑な基準でソートする必要がある場合には、 この関数を使う必要があります。

関数 cmp_function は、 array のキーペアによって満たされる 2 つのパラメータを受け取ります。 第 1 引数が第 2 引数と等しいあるいは大きいと見なさない場合、 この比較関数は、0 に等しいあるいはそれより大きな整数を返してはなりません。

成功した場合に TRUE を、失敗した場合に FALSE を返します。

例 1. uksort() example

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

$a = array(4 => "four", 3 => "three", 20 => "twenty", 10 => "ten");

uksort($a, "cmp");

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

上の例の出力は以下となります。

20: twenty
10: ten
4: four
3: three

usort(), uasort(), sort(), asort(), arsort(), ksort(), natsort(), rsort() も参照ください。