PHP - Ds Deque::insert() 函数

PHP 的 Ds\Deque::insert() 函数用于在指定索引处的当前双端队列中插入一个值。索引是双端队列中元素的位置，从 0 开始表示第一个元素，1 表示第二个元素，依此类推。

如果指定的索引值无效，这意味着负数或大于双端队列的大小，它将抛出“OutOfRangeException”异常。

语法

以下是 PHP Ds\Deque::insert() 函数的语法 -

public Ds\Deque::insert(int $index, mixed ...$values): void 

参数

以下是此函数的参数 -

• index - 它表示一个整数，指定要插入的索引。
• values - 需要插入的整数值。

返回值

此函数不返回任何值；相反，它将值插入到双端队列中。

示例 1

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

<?php
   $deque = new \Ds\Deque([2, 3, 4, 5]);
   echo "The deque elements are: \n";
   print_r($deque);
   $index = 0;
   $value = 1;
   echo "The given index and value is: ".$index.", ".$value;
   echo "\nThe deque after a new element is inserted: ";
   #using insert() function
   $deque->insert($index, $value);
   print_r($deque);
?>

输出

以上程序显示以下输出 -

The deque elements are:
Ds\Deque Object
(
    [0] => 2
    [1] => 3
    [2] => 4
    [3] => 5
)
The given index and value is: 0, 1
The deque after a new element is inserted: Ds\Deque Object
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
)

示例 2

以下是 PHP Ds\Deque::insert() 函数的另一个示例。我们使用此函数在此双端队列 ([10, 20, 30, 50]) 中的指定索引 3 处插入值 40 -

<?php
   $deque = new \Ds\Deque(["Tutorials", "Point"]);
   echo "The elements of deque: \n";
   print_r($deque);
   $index = 2;
   $value = "India";
   echo "The given index and value is: ".$index.", ".$value;
   echo "\nThe deque after new elements inserted: \n";
   #using insert() function
   $deque->insert($index, $value);
   print_r($deque);
?>

输出

执行上述程序后，将生成以下输出 -

The elements of deque:
Ds\Deque Object
(
    [0] => Tutorials
    [1] => Point
)
The given index and value is: 2, India
The deque after new elements inserted:
Ds\Deque Object
(
    [0] => Tutorials
    [1] => Point
    [2] => India
)

示例 3

如果指定的 index 值“大于”双端队列的大小，此函数将抛出 “OutOfRangeException”，如下所示 -

<?php
   $deque = new \Ds\Deque([10, 20, 30, 40]);
   echo "The original deque: \n";
   print_r($deque);
   $index = 5;
   $val = 50;
   echo "The given and value is: ".$index.", ".$val;
   echo "\nThe deque after inserting new value: \n";
   $deque->insert($index, $val);
   print_r($deque);
?>

输出

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

The original deque:
Ds\Deque Object
(
    [0] => 10
    [1] => 20
    [2] => 30
    [3] => 40
)
The given and value is: 5, 50
The deque after inserting new value:
PHP Fatal error:  Uncaught OutOfRangeException: Index out of range: 
5, expected 0 <= x <= 3 in C:\Apache24\htdocs\index.php:9
Stack trace:
#0 C:\Apache24\htdocs\index.php(9): Ds\Deque->insert(5, 50)
#1 {main}
  thrown in C:\Apache24\htdocs\index.php on line 9