PHP | Función Ds\\Map ksorted()

La función Ds\Map::ksorted() es una función incorporada en PHP, que se utiliza para devolver una copia ordenada por clave.

Sintaxis:

Ds\Map public Ds\Map::ksorted ([ callable $comparator ] )

Parámetro: esta función acepta un único parámetro $comparator que contiene una función según la cual se compararán los valores mientras se ordena la copia del mapa. 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.
• 0, si se espera que el primer elemento sea igual al segundo elemento.

Valor de retorno: esta función devuelve una copia del mapa que se ordena por clave.

Los siguientes programas ilustran la función Ds\Map::ksorted() en PHP:

Programa 1:

<?php 
// PHP program to illustrate ksorted() function 
  
// Declare a Map 
$map = new \Ds\Map([1 => 20, 3 => 10, 2 => 30]); 
  
// Print the sorted copy of Map by key
print_r($map->ksorted()); 
  
?>

Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => 1
            [value] => 20
        )

    [1] => Ds\Pair Object
        (
            [key] => 2
            [value] => 30
        )

    [2] => Ds\Pair Object
        (
            [key] => 3
            [value] => 10
        )

)

Programa 2:

<?php 
// PHP program to illustrate ksorted() function 
  
// Declare a Map 
$map = new \Ds\Map(["x" => "Geeks",
        "a" => "for", "z" => "Geeks"]); 
  
// Print the sorted copy Map 
print_r($map->ksorted()); 
  
?> 

Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => a
            [value] => for
        )

    [1] => Ds\Pair Object
        (
            [key] => x
            [value] => Geeks
        )

    [2] => Ds\Pair Object
        (
            [key] => z
            [value] => Geeks
        )

)

Referencia: https://www.php.net/manual/en/ds-map.ksorted.php