Ds\Sequence::merge

(PECL ds >= 1.0.0)

Ds\Sequence::mergeReturns the result of adding all given values to the sequence

説明

abstract public Ds\Sequence::merge(mixed $values): Ds\Sequence

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

パラメータ

values

A traversable object or an array.

戻り値

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

注意:

The current instance won't be affected.

例1 Ds\Sequence::merge() example

<?php
$sequence 
= new \Ds\Vector([123]);

var_dump($sequence->merge([456]));
var_dump($sequence);
?>

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

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)
}
関連キーワード:  Ds, int, Sequence, values, adding, result, all, given, sequence, merge