PHP - Ds Vector::first() 函数

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

Ds\Vector 类还提供了一个 get() 函数，允许您检索指定索引处的 value。如果将索引指定为 0，则可以检索向量中的第一个元素。

语法

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

public Ds\Vector::first(): mixed

参数

此函数不接受任何参数。

返回值

此函数返回向量中的第一个值。

示例 1

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

<?php
   $vector = new \Ds\Vector([1, 2, 3, 4, 5]);
   echo "The vector elements are: \n";
   print_r($vector);
   echo("The first element of vector: "); 
   var_dump($vector->first());
?>

输出

上述程序输出如下：

The vector elements are:
Ds\Vector Object
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
)
The first element of vector: int(1)

示例 2

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

<?php
   $vector = new \Ds\Vector(["Tutorials", "Point", "India"]);
   echo "The vector elements are: \n";
   print_r($vector);
   echo("The first element of vector: "); 
   var_dump($vector->first());
?>

输出

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

The vector elements are:
Ds\Vector Object
(
    [0] => Tutorials
    [1] => Point
    [2] => India
)
The first element of vector: string(9) "Tutorials"

示例 3

如果当前向量为空 ([])，则 first() 函数将抛出 "UnderflowException" 异常：

<?php
   $vector = new \Ds\Vector([]);
   echo "The vector elements are: \n";
   print_r($vector);
   echo("The first element of vector: "); 
   var_dump($vector->first());
?>

输出

上述程序抛出以下异常：

The vector elements are:
Ds\Vector Object
(
)
The first element of vector: 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