PHP | Función Ds\\Set sorted()

La función Ds\Set::sorted() es una función incorporada en PHP que se utiliza para devolver una copia ordenada de un conjunto determinado. Sintaxis:

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

Parámetros: Esta función acepta una función de comparación según la cual se compararán los valores mientras se ordena el Conjunto. El comparador debe devolver los siguientes valores en función de la comparación de dos valores que se le pasan como parámetro:

• 1: si se espera que el primer elemento sea menor que el segundo elemento.
• -1: si se espera que el primer elemento sea mayor que el segundo elemento.
• 0: si se espera que el primer elemento sea igual al segundo elemento.

Valor devuelto: Devuelve la copia ordenada del conjunto dado. Los siguientes programas ilustran la función Ds\Set::sorted() en PHP: Programa 1: 

<?php
// PHP program to illustrate sorted() function
 
$set = new \Ds\Set([20, 10, 30]);
 
// sort the Set
print_r($set->sorted());
 
?>

Ds\Set Object
(
    [0] => 10
    [1] => 20
    [2] => 30
)

Programa 2: 

<?php
 
// Declare a new set
$set = new \Ds\Set([2, 3, 6, 5, 7, 1, 4]);
 
$sorted = $set->sorted(function($a, $b) {
    return $b <=> $a;
});
 
print_r($sorted);
 
?>

Ds\Set Object
(
    [0] => 7
    [1] => 6
    [2] => 5
    [3] => 4
    [4] => 3
    [5] => 2
    [6] => 1
)

Referencia: https://www.php.net/manual/en/ds-set.sorted.php