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），而是返回一个新的双向队列，其中包含符合条件的子队列元素。