Ds\Deque::slice()函式—用法及示例

函式名：Ds\Deque::slice()

適用版本：PHP 7.3 及以上版本

用法：該函式用於從一個雙向佇列（Deque）中提取一個指定範圍的子佇列，並返回一個新的雙向佇列。

語法：public function slice(int $index, ?int $length = null): Deque

引數：

1. $index：表示子佇列的起始索引，可以為負數（表示從佇列末尾開始計算索引）。
2. $length：可選引數，表示子佇列的長度，預設為 null，如果不指定則提取從 $index 到佇列末尾的全部元素。如果為負數，則表示從 $index 開始往前提取 $length 個元素。

返回值：返回一個包含符合條件的子佇列元素的新雙向佇列（Deque）。

示例：

use Ds\Deque;

$deque = new Deque(['a', 'b', 'c', 'd', 'e']);

// 提取索引為 1 到末尾的子佇列
$slice1 = $deque->slice(1);
var_dump($slice1->toArray()); // 輸出：array(4) { ["b", "c", "d", "e"] }

// 提取索引為 0 到 2 的子佇列
$slice2 = $deque->slice(0, 3);
var_dump($slice2->toArray()); // 輸出：array(3) { ["a", "b", "c"] }

// 提取索引為 -2 到末尾的子佇列
$slice3 = $deque->slice(-2);
var_dump($slice3->toArray()); // 輸出：array(2) { ["d", "e"] }

// 提取索引為 -3 往前的 3 個元素的子佇列
$slice4 = $deque->slice(-3, 3);
var_dump($slice4->toArray()); // 輸出：array(3) { ["c", "d", "e"] }

注意：函式呼叫後不會修改原始雙向佇列（Deque），而是返回一個新的雙向佇列，其中包含符合條件的子佇列元素。