Ds\Map::union

    (PECL ds >= 1.0.0)

    Ds\Map::union — Creates a new map using values from the current instance and another map

    Description

    publicDs\Map::union(Ds\Map$map): Ds\Map

    Creates a new map that contains the pairs of the current instance as well as the pairs of another map.

    A ∪ B = {x: x ∈ A ∨ x ∈ B}

    Note:

    Values of the current instance will be overwritten by those provided where keys are equal.

    Parameters

    map

    The other map, to combine with the current instance.

    Return Values

    A new map containing all the pairs of the current instance as well as another map.

    See Also

    Examples

    Example #1 Ds\Map::union() example

    <?php
    $a     = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
    $b = new \Ds\Map(["b" => 3, "c" => 4, "d" => 5]);

    print_r($a->union($b));
    ?>

    The above example will output something similar to:

    Ds\Map Object ( [0] => Ds\Pair Object ( [key] => a [value] => 1 ) [1] => Ds\Pair Object ( [key] => b [value] => 3 ) [2] => Ds\Pair Object ( [key] => c [value] => 4 ) [3] => Ds\Pair Object ( [key] => d [value] => 5 ) )
    To Top