PHP | Ds\Vector slice()函数

简介

slice() 函数是 PHP Ds\Vector 类中的一个成员方法，用于返回从指定起始位置开始到指定结束位置的元素组成的新 Vector 对象。

语法

public function slice(int $index, int $length = null): \Ds\Vector

参数

index: 必需，表示起始位置索引。

length: 可选，表示要获取元素的数量。

返回值

返回由指定范围内的元素组成的新 Vector 对象。如果结束位置索引未指定，将返回起始位置索引及其后面的所有元素组成的 Vector 对象。

示例

<?php
$vector = new \Ds\Vector([1, 2, 3, 4, 5]);
$slice1 = $vector->slice(1, 3);  // 返回索引 1 到索引 3 的元素组成的 Vector 对象
$slice2 = $vector->slice(2);  // 返回索引 2 到末尾的元素组成的 Vector 对象

print_r($slice1);
print_r($slice2);
?>

输出：

Ds\Vector Object
(
    [0] => 2
    [1] => 3
    [2] => 4
)
Ds\Vector Object
(
    [0] => 3
    [1] => 4
    [2] => 5
)

注意事项

• index 和 length 参数都必须是非负整数，如果不是将会抛出异常；

• 如果 length 参数未指定，将默认返回从 index 开始到 Vector 对象尾部的所有元素组成的 Vector 对象；

• 如果 index 参数超出了 Vector 对象的索引范围，将会直接返回一个空的 Vector 对象。