Ds\Sequence::insert

(PECL ds >= 1.0.0)

Ds\Sequence::insert — Вставляет значения по указанному индексу

Описание

Вставляет значения по указанному индексу.

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

index

Индекс, по которому необходимо осуществить вставку. 0 <= index <= count

Замечание:

Можно указывать индекс, равный количеству элементов коллекции.

values

Значение или значения для вставки.

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

Функция не возвращает значения после выполнения.

Ошибки

Выбрасывает исключение OutOfRangeException в случае некорректного индекса.

Примеры

<?php
$sequence = new \Ds\Vector();
$sequence->insert(0, "e"); // [e]
$sequence->insert(1, "f"); // [e, f]
$sequence->insert(2, "g"); // [e, f, g]
$sequence->insert(0, "a", "b"); // [a, b, e, f, g]
$sequence->insert(2, ...["c", "d"]); // [a, b, c, d, e, f, g]
var_dump($sequence);
?>

object(Ds\Vector)#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"
}