# Ds\Deque::sorted

(PECL ds >= 1.0.0)

Ds\Deque::sorted — Renvoie une copie triée

### Description

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

Renvoie une copie triée du deque, en utilisant une fonction `comparator` optionnelle.

### 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.

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

  Retourner des valeurs non-entières à partir de la fonction de comparaison, telles que float, entraînera une conversion interne de la valeur de retour du rappel en int. Ainsi, des valeurs telles que `0.99` et `0.1` seront toutes deux converties en une valeur entière de `0`, ce qui comparera de telles valeurs comme égales.

### Valeurs de retour

Renvoie une copie triée du deque.

### Exemples

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

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

Résultat de l'exemple ci-dessus est similaire à :

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

Exemple #2 Exemple de Ds\Deque::sorted() utilisant un comparateur

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

Résultat de l'exemple ci-dessus est similaire à :

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