PHP - Ds Sequence::first() 函数

PHP 的 Ds\Sequence::first() 函数用于检索序列中的第一个值。如果当前序列为空 ([])，此函数将抛出“UnderflowException”异常。

PHP Ds\Sequence 类提供另一个名为 get() 的函数，该函数检索特定索引处的元素。如果索引为 0，它始终返回序列中的 第一个值。

语法

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

abstract public Ds\Sequence::first(): mixed

参数

此函数不接受任何参数。

返回值

此函数返回序列中的第一个值。

示例 1

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

<?php
   $seq = new \Ds\Vector([1, 2, 3, 4, 5]);
   echo "The sequence elements are: \n";
   print_r($seq);
   echo "The first value is sequence is: ";
   print_r($seq->first());
?>

输出

上述程序产生以下输出：

The sequence elements are:
Ds\Vector Object
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
)
The first value is sequence is: 1

示例 2

以下是 PHP Ds\Sequence::first() 函数的另一个示例。我们使用此函数来检索此序列 (["Tutorials", "Point", "India"]) 的第一个元素：

<?php
   $seq = new \Ds\Vector(["Tutorials", "Point", "India"]);
   echo "The sequence elements are: \n";
   print_r($seq);
   echo "The first value is sequence is: ";
   print_r($seq->first());
?>

输出

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

The sequence elements are:
Ds\Vector Object
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
)
The first value is sequence is: 1

示例 3

如果当前序列为空 ([])，此函数将抛出“UnderflowException”异常：

<?php
   $seq = new \Ds\Vector([]);
   echo "The sequence elements are: \n";
   print_r($seq);
   echo "The first value is sequence is: ";
   print_r($seq->first());
?>

输出

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

The sequence elements are:
Ds\Vector Object
(
)
The first value is sequence 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\Vector->first()
#1 {main}
  thrown in C:\Apache24\htdocs\index.php on line 6