Ds\Sequence::sorted

(PECL ds >= 1.0.0)

Ds\Sequence::sorted — Возвращает отсортированную по значению копию коллекции

abstract public Ds\Sequence::sorted ( callable $comparator = ? ) : Ds\Sequence

Возвращает отсортированную копию коллекции, опционально используя callback-функцию comparator.

comparator: Функция сравнения должна возвращать целое, которое меньше, равно или больше нуля, если первый аргумент является соответственно меньшим, равным или большим, чем второй.

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

Предостережение
Не целое значение возвращенное из функции сравнения, такого как float, будет приведено к целому числу (int). Так что значения типа 0.99 и 0.1 будут приведены к 0, что будет означать равенство сравниваемых значений.

Возвращает отсортированную по значению копию коллекции.

Пример #1 Пример использования Ds\Sequence::sorted()


<?php
$sequence = new \Ds\Vector([4, 5, 1, 3, 2]);

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

Результатом выполнения данного примера будет что-то подобное:

Ds\Vector Object
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
)

Пример #2 Пример использования Ds\Sequence::sorted() с callback-функцией сравнения


<?php
$sequence = new \Ds\Vector([4, 5, 1, 3, 2]);

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

print_r($sorted);
?>

Результатом выполнения данного примера будет что-то подобное:

Ds\Vector Object
(
    [0] => 5
    [1] => 4
    [2] => 3
    [3] => 2
    [4] => 1
)