Ds\Sequence::sorted

(PECL ds >= 1.0.0)

Ds\Sequence::sorted — 返回排序後的副本

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

使用選用的 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() 範例

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

此頁面沒有使用者貢獻的註解。