PHP - Ds Deque::pop() 函式

PHP 的Ds\Deque::pop()函式用於移除當前雙端佇列中的最後一個元素，並返回最後一個被移除的值。如果當前雙端佇列為空 ([]), 此函式將丟擲“UnderflowException”異常。

在雙端佇列上呼叫此函式後，雙端佇列的大小將減少1。

語法

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

public Ds\Deque::pop(): mixed

引數

此函式不接受任何引數。

返回值

此函式返回最後一個被移除的值。

示例 1

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

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

輸出

執行上述程式後，將顯示以下輸出：

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

示例 2

以下是 PHP Ds\Deque::pop()函式的另一個示例。我們使用此函式來移除此雙端佇列(["Hello","world","!"])的最後一個元素：

<?php
   $deque = new \Ds\Deque(["Hello","world","!"]);
   echo "The deque elements are:\n ";
   print_r($deque);
   echo "The last removed element: ";
   print_r($deque->pop());
   echo "\nThe deque after remove last element: \n";
   print_r($deque);
?>

輸出

執行上述程式後，將顯示以下輸出：

The deque elements are:
 Ds\Deque Object
(
    [0] => Hello
    [1] => world
    [2] => !
)
The last removed element: !
The deque after remove last element:
Ds\Deque Object
(
    [0] => Hello
    [1] => world
)

示例 3

如果當前雙端佇列為空([])，此函式將丟擲“UnderflowException”異常，如下所示：

<?php
   $deque = new \Ds\Deque([]);
   echo "The deque elements are:\n";
   print_r($deque);
   echo "The last removed element: ";
   print_r($deque->pop());
   echo "\nThe deque after remove last element: \n";
   print_r($deque);
?>

輸出

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

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