Ds\Set::first()函式—用法及示例

函式： Ds\Set::first()

適用版本： PHP 7.3 及以上版本

用法：該函式用於獲取集合中的第一個元素。

語法：public function first(): mixed

引數：無引數

返回值：返回集合中的第一個元素的值，如果集合為空，返回 null。

示例：

// 建立一個集合
$set = new Ds\Set([1, 2, 3, 4, 5]);

// 獲取集合中的第一個元素
$firstElement = $set->first();

// 輸出結果
var_dump($firstElement); // int(1)

在上面的示例中，首先我們建立了一個包含整數的集合。然後，我們使用 first() 函式獲取了集合中的第一個元素，並將結果賦給 $firstElement 變數。最後，我們使用 var_dump() 函式輸出了第一個元素的值。在這個例子中，集合的第一個元素是整數 1，因此輸出結果為 int(1)。

如果集合為空，first() 函式將返回 null。下面是一個示例：

// 建立一個空集合
$emptySet = new Ds\Set();

// 獲取集合中的第一個元素
$firstElement = $emptySet->first();

// 輸出結果
var_dump($firstElement); // NULL

在這個示例中，由於集合為空，first() 函式將返回 null，並以 NULL 的形式輸出結果。

請注意，在使用 first() 函式之前，您需要確保已經使用 add() 函式或透過建構函式將元素新增到集合中，否則集合將為空。