Retorna uma cópia ordenada

# Ds\Deque::sorted

(PECL ds >= 1.0.0)

Ds\Deque::sorted — Retorna uma cópia ordenada

### Descrição

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

Retorna uma cópia ordenada, usando uma função de `comparator` opcional.

### Parâmetros

`comparator`
  A função de comparação deve retornar um inteiro menor que, igual ou maior que zero se o primeiro argumento for considerado respectivamente menor que, igual ou maior que o segundo.
  function callback(mixed `$a`, mixed `$b`): int
  Cuidado

  Retornar valores não inteiros da função de comparação, como float, resultará em uma conversão interna do valor retornado da função callback para int. Portanto, valores como `0.99` e `0.1` serão convertidos para o valor inteiro `0`, o que comparará esses valores como iguais.

### Valor Retornado

Retorna uma cópia ordenada da deque.

### Exemplos

Exemplo #1 Exemplo de Ds\Deque::sorted()

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

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

O exemplo acima produzirá algo semelhante a:

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

Exemplo #2 Ds\Deque::sorted() exemplo usando um comparador

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

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

    print_r($sorted);
    ?>

O exemplo acima produzirá algo semelhante a:

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

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