Ds\Vector::insert()函式—用法及示例

函式名：Ds\Vector::insert()

適用版本：PHP 7.2及以上

用法：insert()函式用於在指定的索引位置插入一個或多個元素到Vector中。插入的元素會改變Vector中現有元素的索引。

語法：public function insert(int $index, mixed ...$values): void

引數：

• $index：指定插入位置的索引，合法的索引範圍是0到Vector中元素個數。
• $values：要插入到Vector的元素。可以傳入一個或多個引數。

返回值：無返回值。

示例：

// 建立一個空的Vector物件
$vector = new Ds\Vector();

// 插入一個元素到索引為1的位置
$vector->insert(1, 'apple');
print_r($vector);  // 輸出：Ds\Vector Object ( [0] => apple )

//在Vector中已有元素的位置插入多個元素
$vector->insert(1, 'banana', 'orange', 'grape');
print_r($vector);  // 輸出：Ds\Vector Object ( [0] => apple [1] => banana [2] => orange [3] => grape )

// 嘗試在非法的索引位置插入元素
$vector->insert(5, 'pear');  // 丟擲OutOfBoundsException異常

注意：Ds\Vector是PHP擴充套件庫Ds提供的資料結構，需要安裝並啟用Ds擴充套件才能使用。在呼叫insert()函式前需要先建立一個Vector物件。