php8.5
Home/ Manual/ ds / map/ Ds\Map::ksort

Ds\Map::ksort

PHP function Edit on GitHub ✎

(PECL ds >= 1.0.0)

Sorts the map in-place by key

Description

Ds\Map::ksort([callable $comparator]): void

Sorts the map in-place by key, using an optional comparator function.

Parameters

comparator

Description

Return Values

Void

Examples

Ds\Map::ksort() example

php
<?php
$map = new \Ds\Map(["b" => 2, "c" => 3, "a" => 1]);
$map->ksort();

print_r($map);
?>

The above example will output something similar to:

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

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

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

)

Ds\Map::ksort() example using a comparator

php
<?php
$map = new \Ds\Map([1 => "x", 2 => "y", 0 => "z"]);

// Reverse
$map->ksort(function($a, $b) {
    return $b <=> $a;
});

print_r($map);
?>

The above example will output something similar to:

output
Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => 2
            [value] => y
        )

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

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

)

Source: reference/ds/ds/map/ksort.xml · from the official PHP manual (php/doc-en)