Ds\Vector::shift()函数—用法及示例

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

函数描述：这个函数用于从向量的开头移除并返回第一个元素。

参数：无

返回值：成功地从向量的开头移除并返回第一个元素，如果向量为空则返回NULL。

适用版本：这个方法是在PHP版本7.1.0及以上的Ds扩展中引入的。

用法示例：

<?php

use Ds\Vector;

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

$firstElement = $vector->shift();
var_dump($firstElement); // 输出: int(1)
var_dump($vector->toArray()); // 输出: array(2) { [0]=> int(2) [1]=> int(3) }

$emptyVector = new Vector();
$nullElement = $emptyVector->shift();
var_dump($nullElement); // 输出: NULL
var_dump($emptyVector->isEmpty()); // 输出: bool(true)

?>

在示例中，我们首先创建一个包含数字1、2和3的向量。然后，我们使用shift()方法将第一个元素1从向量中移除并赋值给变量$firstElement。然后，我们通过调用toArray()方法来检查向量的剩余元素，输出为[2, 3]。接下来，我们创建一个空向量，并使用shift()方法移除第一个元素，由于向量为空，所以返回值为NULL，并通过调用isEmpty()方法检查向量是否为空，输出为true。