PHP - Ds Set first() 函数

PHP 的 Ds\Set::first() 函数用于检索当前集合的第一个值。它不接受任何索引值来检索元素；它只返回集合的第一个元素。

如果当前集合为空，此函数将抛出“UnderflowException”异常。

语法

以下是PHP Ds\Set::first() 函数的语法：

public Ds\Set::first(): mixed

参数

此函数不接受任何参数。

返回值

此函数返回集合中的第一个值。

示例 1

以下是PHP Ds\Set::first() 函数的基本示例。

<?php
   $set = new \Ds\Set([11, 121, 12121, 1212121]);
   echo "The set elements are: \n";
   print_r($set);
   echo "The first element of the set is: ";
   #using first() function
   print_r($set->first());
?>

输出

以上程序产生以下输出：

The set elements are:
Ds\Set Object
(
    [0] => 11
    [1] => 121
    [2] => 12121
    [3] => 1212121
)
The first element of the set is: 11

示例 2

以下是PHP Ds\Set::first() 函数的另一个示例。我们使用此函数来检索此集合(["Welcome", "to", "Tutorials", "point"]) 的第一个元素。

<?php
   $set = new \Ds\Set(["Welcome", "to", "Tutorials", "point"]);
   echo "The set elements are: \n";
   print_r($set);
   echo "The first element of the set is: ";
   print_r($set->first());
?>

输出

执行以上程序后，它将显示以下输出：

The set elements are:
Ds\Set Object
(
    [0] => Welcome
    [1] => to
    [2] => Tutorials
    [3] => point
)
The first element of the set is: Welcome

示例 3

如果当前集合为空，此函数将抛出“UnderflowException”异常。

<?php
   $set = new \Ds\Set([]);
   echo "The set elements are: ";
   print_r($set);
   echo "The first element of the set is: ";
   print_r($set->first());
?>

输出

执行以上程序后，它将抛出以下异常：

The set elements are: Ds\Set Object
(
)
The first element of the set is: PHP Fatal error:  Uncaught UnderflowException: 
Unexpected empty state in C:\Apache24\htdocs\index.php:6
Stack trace:
#0 C:\Apache24\htdocs\index.php(6): Ds\Set->first()
#1 {main}
  thrown in C:\Apache24\htdocs\index.php on line 6