Ds\Map::union
En esta página
Ds\Map::union
Crear un nuevo mapa utilizando los valores de la instancia actual y de otro mapa
Descripción#
public Ds\Map::union(Ds\Map $map): Ds\Map
```php
Crear un nuevo mapa que contiene los pares de la instancia actual así como los pares de otro `map`.
`A ∪ B = {x: x ∈ A ∨ x ∈ B}`
> [!NOTE]
> Los valores de la instancia actual serán sobrescritos por aquellos proporcionados cuando las claves sean iguales.
## Parámetros
`map`
El otro mapa, a combinar con la instancia actual.
## Valores devueltos
Un nuevo mapa que contiene todos los pares de la instancia actual así como de otro `map`.
## Véase también
[Unión](https://en.wikipedia.org/wiki/Union_(set_theory)) en Wikipedia
## Ejemplos
Ejemplo de `Ds\Map::union`
```php
Resultado del ejemplo anterior es similar a:
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
)
)