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]

注意：該方法直接修改原有的雙端佇列，並返回新佇列的長度。