Ds\Vector::insert

(PECL ds >= 1.0.0)

Ds\Vector::insertInserts values at a given index

Descrição

public Ds\Vector::insert ( int $index [, mixed $...values ] ) : void

Inserts values into the vector 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.

Valor Retornado

Não há valor retornado.

Erros

OutOfRangeException if the index is not valid.

Exemplos

Exemplo #1 Ds\Vector::insert() example

<?php
$vector 
= new \Ds\Vector();

$vector->insert(0"e");             // [e]
$vector->insert(1"f");             // [e, f]
$vector->insert(2"g");             // [e, f, g]
$vector->insert(0"a""b");        // [a, b, e, f, g]
$vector->insert(2, ...["c""d"]);   // [a, b, c, d, e, f, g]

var_dump($vector);
?>

O exemplo acima irá imprimir algo similar à:

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