Ds\Sequence::insert

(PECL ds >= 1.0.0)

Ds\Sequence::insert — Inserts values at a given index

Descripción

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

Inserts values into the sequence at a given index.

Parámetros

index: The index at which to insert. 0 <= index <= count
Nota:
You can insert at the index equal to the number of values.
values: The value or values to insert.

Valores devueltos

No devuelve ningún valor.

Errores/Excepciones

OutOfRangeException if the index is not valid.

Ejemplos

Ejemplo #1 Ds\Sequence::insert() example

<?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);
?>

El resultado del ejemplo sería algo similar a:

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" }