Returns a sorted copy

# Ds\Deque::sorted

(PECL ds >= 1.0.0)

Ds\Deque::sorted — Returns a sorted copy

### 说明

public function Ds\Deque::sorted(callable `$comparator` = ?): Ds\Deque

Returns a sorted copy, using an optional `comparator` function.

### 参数

`comparator`
  在第一个参数小于，等于或大于第二个参数时，该比较函数必须相应地返回一个小于，等于或大于 0 的整数。
  function callback(mixed `$a`, mixed `$b`): int
  警告

  从比较函数中返回非整数值，例如 float，将导致内部强制转换为 callback 返回值为 int。因此，诸如 `0.99` 和 `0.1` 之类的值都将被转换为整数值 `0`，将这些值比较的话将会是相等。

### 返回值

Returns a sorted copy of the deque.

### 示例

示例 #1 Ds\Deque::sorted() example

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

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

以上示例的输出类似于：

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

示例 #2 Ds\Deque::sorted() example using a comparator

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

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

    print_r($sorted);
    ?>

以上示例的输出类似于：

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open