# Ds\Vector::merge

(PECL ds >= 1.0.0)

Ds\Vector::merge — Returns the result of adding all given values to the vector

### Description

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

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

### Parameters

`values`

  A traversable object or an array.

### Return Values

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

> Note:

> The current instance won't be affected.

### Examples

Example #1 Ds\Vector::merge() example

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

The above example will output something similar to:

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