Ds\Sequence::first()函数—用法及示例

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

函数说明：该函数用于获取序列的第一个元素。

函数用法：可以使用该函数来访问序列的第一个元素。

参数说明：无需提供参数。

返回值：返回序列的第一个元素。

示例代码：

// 创建一个序列
$sequence = new \Ds\Vector([1, 2, 3, 4, 5]);

// 获取序列的第一个元素
$firstElement = $sequence->first();

// 输出结果
echo $firstElement; // 输出：1

注意事项：如果序列为空，即没有元素，调用first()函数将会抛出UnderflowException异常。因此，在调用first()函数之前，建议先使用isEmpty()函数检查序列是否为空。