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