PHP - Ds Deque::remove() 函式

PHP 的 Ds\Deque::remove() 函式從當前雙端佇列的指定索引處刪除一個元素，並返回已刪除的元素。 “索引”是雙端佇列中元素的位置，從 0 開始，表示第一個元素，1 表示第二個元素，依此類推。

如果指定的索引引數值 無效，即為負數或大於雙端佇列的大小，則此函式將丟擲“OutOfRangeException”異常。

語法

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

public Ds\Deque::remove(int $index): mixed

引數

此函式接受一個名為“index”的引數，如下所述：

• index − 一個整數，表示要刪除的值的索引。

返回值

此函式返回已刪除的值。

示例 1

刪除雙端佇列的 第一個 元素。

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

<?php
   $deque = new \Ds\Deque([10, 20, 30, 40, 50]);
   echo "The original deque elements are: \n";
   print_r($deque);
   $index = 0;
   echo "Index value:".$index;
   echo "\nThe removed element is: ";
   print_r($deque->remove($index));
?>

輸出

上述程式產生以下輸出：

The original deque elements are:
Ds\Deque Object
(
    [0] => 10
    [1] => 20
    [2] => 30
    [3] => 40
    [4] => 50
)
Index value:0
The removed element is: 10

示例 2

以下是 PHP Ds\Deque::remove() 函式的另一個示例。我們使用此函式從該雙端佇列 (['a', 'b', 'c']) 中刪除指定索引 2 處的元素：

<?php
   $deque = new \Ds\Deque(['a', 'b', 'c']);
   echo "The original deque elements are: \n";
   print_r($deque);
   $index  = 2;
   echo "Index value: ".$index;
   echo "\nThe removed element is: ";
   print_r($deque->remove($index));
   echo "\nThe deque after removed: \n";
   print_r($deque);
?>

輸出

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

The original deque elements are:
Ds\Deque Object
(
    [0] => a
    [1] => b
    [2] => c
)
Index value: 2
The removed element is: c
The deque after removed:
Ds\Deque Object
(
    [0] => a
    [1] => b
)

示例 3

如果指定的索引值 無效，則此函式將丟擲 OutOfRangeException，如下所示

<?php
   $deque = new \Ds\Deque(["Tutorials", "Point"]);
   echo "The original deque: \n";
   print_r($deque);
   $index = 5;
   echo "Index value: ".$index;
   echo "\nThe removed element: ";
   print_r($deque->remove($index));
?>

輸出

執行上述程式後，將生成以下輸出：

The original deque:
Ds\Deque Object
(
    [0] => Tutorials
    [1] => Point
)
Index value: 5
The removed element: PHP Fatal error:  Uncaught OutOfRangeException: 
Index out of range: 5, expected 0 <= x >= 1 in C:\Apache24\htdocs\index.php:8
Stack trace:
#0 C:\Apache24\htdocs\index.php(8): Ds\Deque->remove(5)
#1 {main}
  thrown in C:\Apache24\htdocs\index.php on line 8