Ds\Map::sorted

    (PECL ds >= 1.0.0)

    Ds\Map::sorted — Returns a copy, sorted by value

    説明

    publicDs\Map::sorted(callable$comparator = ?): Ds\Map

    Returns a copy, sorted by value using an optional comparator function.

    パラメータ

    comparator

    比較関数は、最初の引数と二番目の引数の比較結果を返します。最初の引数のほうが二番目の引数より大きい場合は正の整数を、二番目の引数と等しい場合はゼロを、そして二番目の引数より小さい場合は負の整数を返す必要があります。

    callback(mixed$a, mixed$b): int
    警告

    float のような 非整数 を比較関数が返すと、その返り値を内部的に int にキャストして使います。 つまり、0.99 や 0.1 といった値は整数値 0 にキャストされ、 値が等しいとみなされます。

    戻り値

    Returns a copy of the map, sorted by value.

    例

    例1 Ds\Map::sort() example

    <?php
    $map     = new \Ds\Map(["a" => 2, "b" => 3, "c" => 1]);

    print_r($map->sorted());
    ?>

    上の例の出力は、 たとえば以下のようになります。

    Ds\Map Object ( [0] => Ds\Pair Object ( [key] => c [value] => 1 ) [1] => Ds\Pair Object ( [key] => a [value] => 2 ) [2] => Ds\Pair Object ( [key] => b [value] => 3 ) )

    例2 Ds\Map::sort() example using a comparator

    <?php
    $map     = new \Ds\Map(["a" => 2, "b" => 3, "c" => 1]);

    // Reverse
    $sorted = $map->sorted(function($a, $b) {
    return     $b <=> $a;
    });

    print_r($sorted);
    ?>

    上の例の出力は、 たとえば以下のようになります。

    Ds\Map Object ( [0] => Ds\Pair Object ( [key] => b [value] => 3 ) [1] => Ds\Pair Object ( [key] => a [value] => 2 ) [2] => Ds\Pair Object ( [key] => c [value] => 1 ) )
    To Top