Ds\Vector::insert

(PECL ds >= 1.0.0)

Ds\Vector::insertInserts values at a given index

Beschreibung

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

Inserts values into the vector at a given index.

Parameter-Liste

index

The index at which to insert. 0 <= index <= count

Hinweis:

You can insert at the index equal to the number of values.

values

The value or values to insert.

Rückgabewerte

Es wird kein Wert zurückgegeben.

Fehler/Exceptions

OutOfRangeException if the index is not valid.

Beispiele

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

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

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