Returns the result of adding all given values to the set

# Ds\Set::merge

(PECL ds >= 1.0.3)

Ds\Set::merge — Returns the result of adding all given values to the set

### 説明

public Ds\Set::merge ( mixed `$values` ) : Ds\Set

Returns the result of adding all given values to the set.

### パラメータ

`values`

  A traversable object or an array.

### 返り値

The result of adding all given values to the set, effectively the same as adding the values to a copy, then returning that copy.

> 注意:

> The current instance won't be affected.

### 例

例1 Ds\Set::merge() example

`<?php
$set = new \Ds\Set([1, 2, 3]);
var_dump($set->merge([3, 4, 5]));
var_dump($set);
?>`

上の例の出力は、 たとえば以下のようになります。

    object(Ds\Set)#2 (6) {
      [0]=>
      int(1)
      [1]=>
      int(2)
      [2]=>
      int(3)
      [3]=>
      int(4)
      [4]=>
      int(5)
    }
    object(Ds\Set)#1 (3) {
      [0]=>
      int(1)
      [1]=>
      int(2)
      [2]=>
      int(3)
    }