[函数]Ds\Sequence::shift()函数—用法及示例

函数名称：Ds\Sequence::shift()

函数描述：该方法从序列中移除并返回第一个元素。

适用版本：PHP 7.1.0 及以上版本。

用法：

$sequence = new \Ds\Vector([1, 2, 3]);

$value = $sequence->shift();
echo $value; // 输出：1

print_r($sequence); // 输出：Ds\Vector Object ([1, 2, 3])

示例解释：

1. 首先，我们创建了一个 Ds\Vector 序列，并初始化了一些元素。
2. 然后我们调用 shift() 函数，将序列中的第一个元素弹出并赋值给 $value 变量。
3. 最后，我们输出 $value 的值，可以看到它是序列中的第一个元素 1。
4. 我们还使用了 print_r() 函数来查看序列中剩余的元素，可以看到元素 1 已被移除，序列变为 [2, 3]。

注意事项：

• 如果序列为空，调用 shift() 方法将引发 UnderflowException 异常。
• shift() 方法会修改原始序列，将其改为移除第一个元素后的新序列。