[函数]Ds\Deque::insert()函数—用法及示例

PHP函数：Ds\Deque::insert()

适用版本：PHP 7.0及以上

用法：Ds\Deque::insert()方法用于在指定位置插入一个或多个元素到双端队列中。

参数：

1. $index（必需）：指定插入元素的位置。如果位置是一个负数，则会从队列的末尾开始计算。
2. $values（必需）：要插入的元素。可以是单个元素或一个数组。

返回值：插入元素后的新队列的长度。

示例：

$deque = new \Ds\Deque([1, 2, 3]);

// 在索引位置1插入一个元素
$deque->insert(1, 4);
// 输出：[1, 4, 2, 3]

// 在索引位置0插入多个元素
$deque->insert(0, [5, 6]);
// 输出：[5, 6, 1, 4, 2, 3]

// 在索引位置-1插入一个元素（从末尾开始计算）
$deque->insert(-1, 7);
// 输出：[5, 6, 1, 4, 2, 7, 3]

注意：该方法直接修改原有的双端队列，并返回新队列的长度。