Ds\Sequence::insert

    (PECL ds >= 1.0.0)

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

    Описание

    abstractpublicDs\Sequence::insert(int$index, mixed...$values): void

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

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

    index

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

    Замечание:

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

    values

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

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

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

    Ошибки

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

    Примеры

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

    <?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" }
    To Top