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

函数：Ds\Vector::first()

适用版本：PHP 7.2.0 及以上版本

用法：Ds\Vector::first() 方法返回 Vector 第一个元素的值。

示例：

<?php
$vector = new \Ds\Vector([1, 2, 3]);

$firstElement = $vector->first();

echo "First element: " . $firstElement; // 输出：First element: 1
?>

在这个示例中，我们首先创建了一个包含整数元素的 Vector 对象。然后，使用 first() 方法获得 Vector 中的第一个元素，并将其赋值给变量 $firstElement。最后，将结果打印出来。

值得注意的是，如果 Vector 中没有元素，调用 first() 方法将会抛出一个异常。因此，在调用此方法之前，最好先检查 Vector 是否为空。例如：

<?php
$vector = new \Ds\Vector();

if ($vector->isEmpty()) {
    echo "Vector is empty.";
} else {
    $firstElement = $vector->first();
    echo "First element: " . $firstElement;
}
?>

在这个示例中，我们使用 isEmpty() 方法检查 Vector 是否为空。如果 Vector 为空，则打印出 "Vector is empty."。如果 Vector 不为空，则获取第一个元素并打印出来。