Ds\Sequence::sorted

(PECL ds >= 1.0.0)

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

Описание

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

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

comparator

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

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

Предостережение

При возврате из функции сравнения нецелых значений наподобие float PHP внутренне приведёт значение, которое возвращает callback-функции, к типу int . Поэтому значения наподобие 0.99 и 0.1 приводятся к целочисленному значению 0 и сравниваются как равные.

Возвращаемые значения

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

Примеры

<?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
)

<?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
)