PHP マニュアル: Inserts values at a given index

説明

abstract public void Ds\Sequence::insert(int $index, mixed ...$values)

Inserts values into the sequence at a given index.

パラメータ

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

注意:
You can insert at the index equal to the number of values.
values: The value or values to insert.

戻り値

値を返しません。

エラー / 例外

OutOfRangeException if the index is not valid.

例

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

上の例の出力は、たとえば以下のようになります。

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