Ds\Map::ksorted

(No version information available, might only be in Git)

Ds\Map::ksorted — Повертає копію колекції, відсортованої за ключами

Опис

public Ds\Map::ksorted(callable $comparator = ?): Ds\Map

Повертає копію колекції, відсортованої за ключами, опціонально використовуючи callback-функцію comparator для порівняння елементів.

Список параметрів

comparator

Функція порівняння повинна повертати ціле, яке менше, дорівнює чи більше нуля, якщо перший аргумент є відповідно меншим, рівним чи більшим, ніж другий.

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

Застереження

Возвращениенецілих значень з функції порівняння, таких як число з плаваючою точкою (float), призведе до внутрішнього приведення значення callback-функції, що повертається, до цілого числа (int). Таким чином, значення 0.99и0.1 будуть приведені до цілого значення що дозволить порівняти ці значення як рівні.

Значення, що повертаються

Повертає копію колекції відсортованої за ключами.

Приклади

Приклад #1 Приклад використання Ds\Map::ksorted()****

Loading...
▶

Висновок наведеного прикладу буде схожим на:

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

    [1] => Ds\Pair Object
        (
            [key] => b
            [value] => 2
        )

    [2] => Ds\Pair Object
        (
            [key] => c
            [value] => 3
        )

)

Приклад #2 Приклад використання Ds\Map::ksorted()** з callback-функцією порівняння**

Loading...
▶

Висновок наведеного прикладу буде схожим на:

Ds\Map Object
Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => 2
            [value] => y
        )

    [1] => Ds\Pair Object
        (
            [key] => 1
            [value] => x
        )

    [2] => Ds\Pair Object
        (
            [key] => 0
            [value] => z
        )

)