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对象。