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