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() 函数或通过构造函数将元素添加到集合中，否则集合将为空。