PHP 8.5.0 Beta 2 available for testing

Ds\Vector::insert

(PECL ds >= 1.0.0)

Ds\Vector::insertInserts values at a given index

Description

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

Inserts values into the vector at a given index.

Parameters

index

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

Note:

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

values

The value or values to insert.

Return Values

No value is returned.

Errors/Exceptions

OutOfRangeException if the index is not valid.

Examples

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

The above example will output something similar to:

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

Found A Problem?

Learn How To Improve This PageSubmit a Pull RequestReport a Bug
+add a note

User Contributed Notes

There are no user contributed notes for this page.

AltStyle によって変換されたページ (->オリジナル) /