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 不為空，則獲取第一個元素並列印出來。