PHP - Ds Deque::last() 函式

PHP 的 Ds\Deque::last() 函式用於檢索當前雙端佇列中的最後一個（或從右側開始的第一個）元素。

如果當前雙端佇列是空的（或它有 0 個元素），此函式將丟擲“UnderflowException”異常。與 first() 函式（返回第一個元素）不同，此函式返回雙端佇列中的最後一個元素。

語法

以下是 PHP Ds\Deque::last() 函式的語法：

public Ds\Deque::last(): mixed

引數

此函式不接受任何引數。

返回值

此函式返回雙端佇列中的最後一個元素。

示例 1

以下程式演示了 Ds\Deque::last() 函式的使用：

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

輸出

以上程式返回雙端佇列的最後一個元素為

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

示例 2

以下是 PHP Ds\Deque::last() 函式的另一個示例。我們使用此函式來檢索此雙端佇列（["Welcome", "to", "Tutorials", "point"]）的最後一個元素：

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

輸出

執行以上程式後，將顯示雙端佇列的最後一個元素：

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

示例 3

如果當前雙端佇列是空的 ([])，此函式將丟擲“UnderflowException”。

在下面的示例中，我們使用 last() 方法來檢索此空雙端佇列 ([]) 的最後一個元素。由於雙端佇列為空，它將丟擲以下異常

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

輸出

執行以上程式後，它將丟擲以下異常：

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