Returns a sorted copy

# Ds\Deque::sorted

(PECL ds >= 1.0.0)

Ds\Deque::sorted — Returns a sorted copy

### Description

public Ds\Deque::sorted ([ callable `$comparator` ] ) : Ds\Deque

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

### Liste de paramètres

`comparator`

  La fonction de comparaison doit retourner un entier inférieur à, égal à, ou supérieur à 0 si le premier argument est considéré comme, respectivement, inférieur à, égal à, ou supérieur au second. Notez qu'avant PHP 7.0.0, cet entier devait être dans l'intervalle -2147483648 à 2147483647

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

  Returning non-integer values from the comparison function, such as float, will result in an internal cast to integer of the callback's return value. So values such as 0.99 and 0.1 will both be cast to an integer value of 0, which will compare such values as equal.

### Valeurs de retour

Returns a sorted copy of the deque.

### Exemples

Exemple #1 Ds\Deque::sorted() example

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

L'exemple ci-dessus va afficher quelque chose de similaire à :

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

Exemple #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);
?>`

L'exemple ci-dessus va afficher quelque chose de similaire à :

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