array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'ds-deque.insert.php', 1 => 'Ds\\Deque::insert', ), 'up' => array ( 0 => 'class.ds-deque.php', 1 => 'Ds\\Deque', ), 'prev' => array ( 0 => 'ds-deque.get.php', 1 => 'Ds\\Deque::get', ), 'next' => array ( 0 => 'ds-deque.isempty.php', 1 => 'Ds\\Deque::isEmpty', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/ds/ds/deque/insert.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PECL ds >= 1.0.0)
Ds\Deque::insert — Вставляет значения по указанному индексу
Вставляет значения по указанному индексу.
index
Индекс, по которому необходимо осуществить вставку. 0 <= index <= count
Замечание:
Можно указывать индекс, равный количеству элементов двухсторонней очереди.
values
Значение или значения для вставки.
Функция не возвращает значения после выполнения.
Выбрасывает исключение OutOfRangeException в случае некорректного индекса.
Пример #1 Пример использования Ds\Deque::insert()
<?php
$deque = new \Ds\Deque();
$deque->insert(0, "e"); // [e]
$deque->insert(1, "f"); // [e, f]
$deque->insert(2, "g"); // [e, f, g]
$deque->insert(0, "a", "b"); // [a, b, e, f, g]
$deque->insert(2, ...["c", "d"]); // [a, b, c, d, e, f, g]
var_dump($deque);
?>
Вывод приведённого примера будет похож на:
object(Ds\Deque)#1 (7) { [0]=> string(1) "a" [1]=> string(1) "b" [2]=> string(1) "c" [3]=> string(1) "d" [4]=> string(1) "e" [5]=> string(1) "f" [6]=> string(1) "g" }