📜  PHP | Ds\Vector slice()函数(1)

📅  最后修改于: 2023-12-03 15:33:32.597000             🧑  作者: Mango

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
)
注意事项
  • indexlength 参数都必须是非负整数,如果不是将会抛出异常;

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

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