array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'ds-map.union.php', 1 => 'Ds\\Map::union', ), 'up' => array ( 0 => 'class.ds-map.php', 1 => 'Ds\\Map', ), 'prev' => array ( 0 => 'ds-map.toarray.php', 1 => 'Ds\\Map::toArray', ), 'next' => array ( 0 => 'ds-map.values.php', 1 => 'Ds\\Map::values', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/ds/ds/map/union.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PECL ds >= 1.0.0)
Ds\Map::union — Creates a new map using values from the current instance and another 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.
map
The other map, to combine with the current instance.
A new map containing all the pairs of the current instance as well as another map
.
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 ) )