Двухсторонняя очередь
PHP Manual

Ds\Deque::merge

(PECL ds >= 1.0.0)

Ds\Deque::mergeВозвращает результат добавления всех заданных значений в коллекцию

Описание

public Ds\Deque Ds\Deque::merge ( mixed $values )

Возвращает результат добавления всех заданных значений в коллекцию.

Список параметров

values

Объект класса traversable или array.

Возвращаемые значения

Результат добавления всех переданных значений в коллекцию. Фактически делается копия коллекции, в которую добавляются значения.

Замечание:

Текущий экземпляр коллекции останется нетронутым.

Примеры

Пример #1 Пример использования Ds\Deque::merge()

<?php
$deque 
= new \Ds\Deque([123]);

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

Результатом выполнения данного примера будет что-то подобное:

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

Двухсторонняя очередь
PHP Manual