PHP | Ds\Sequence unshift()函数

简介

Ds\Sequence unshift()函数用于在序列的开头添加一个或多个元素。

语法

public function unshift(mixed ...$values): int

参数

• $values：要添加到序列开头的一个或多个元素。

返回值

返回添加元素后的序列元素数量。

示例

<?php

use Ds\Vector;

$vector = new Vector([1, 2, 3]);

$vector->unshift(0); // 添加一个元素在开头
print_r($vector); // 输出 Vector Object ([0, 1, 2, 3])

$vector->unshift(-2, -1); // 添加两个元素在开头
print_r($vector); // 输出 Vector Object ([-2, -1, 0, 1, 2, 3])

注意事项

• unshift()函数会改变原始序列，而不是返回新序列。
• 该函数只适用于实现了Ds\Sequence接口的序列类。
• 该函数在向Vector序列的开头添加元素时效率较高，但在向Deque序列的开头添加元素时效率较低。

参考链接

• PHP官方文档
• Ds\Sequence接口文档