php8.5
Home/ Manual/ ds / vector/ Ds\Vector::merge

Ds\Vector::merge

PHP function Edit on GitHub ✎

(PECL ds >= 1.0.0)

Returns the result of adding all given values to the vector

Description

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

Ds\Vector::merge() example

php
<?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:

output
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)
}

Source: reference/ds/ds/vector/merge.xml · from the official PHP manual (php/doc-en)