PHP - Ds Deque::first() 函数

PHP 的 Ds\Deque::first() 函数用于检索当前双端队列中第一个元素的值。Ds\Deque 类提供了另一个名为 get() 的函数，用于检索给定索引处的元素，如果索引为 0，则返回第一个元素。

如果双端队列为空 ([])，则此函数将抛出 "UnderflowException" 异常。

语法

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

public Ds\Deque::first(): mixed

参数

此函数不接受任何参数。

返回值

此函数返回双端队列中的第一个元素。

示例 1

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

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

输出

上述程序显示第一个元素为 '1'：

The deque elements are:
Ds\Deque Object
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
)
The first element of a deque is: 1

示例 2

以下是 PHP Ds\Deque::first() 函数的另一个示例。我们使用此函数检索此双端队列 (["Welcome", "to", "Tutorials", "point"]) 的第一个值：

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

输出

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

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

示例 3

如果当前双端队列为空 ([])，则 first() 函数将抛出 "UnderflowException"，如下所示

<?php
   $deque = new \Ds\Deque([]);
   echo "The deque elements are: \n";
   print_r($deque);
   echo "The first element of a deque is: ";
   print_r($deque->first());
?>

输出

执行上述程序时，它会抛出 "UnderflowException"，如下所示

The deque elements are:
Ds\Deque Object
(
)
The first element of a deque 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\Deque->first()
#1 {main}
  thrown in C:\Apache24\htdocs\index.php on line 6