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()函式檢查序列是否為空。