PHP - Ds Deque::unshift() 函数

PHP 的 Ds\Deque::unshift() 函数用于向双端队列的头部添加一个值。此操作会将现有元素移位以腾出空间用于新值。

使用此函数，您可以一次添加多个值，顺序与传递顺序相同。

语法

以下是 PHP Ds\Deque::unshift() 函数的语法：

public Ds\Deque::unshift(mixed $values = ?): void

参数

此函数接受以下参数：

• values - 需要添加到双端队列头部的值。

返回值

此函数不返回值。

示例 1

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

<?php
   $deque = new \Ds\Deque([12, 24,36,48,60,72]);
   echo "The deque elements are: \n";
   print_r($deque);
   $val = 72;
   echo "The given value: ".$val;
   $deque->unshift(72);
   echo "\nThe deque after adding new element: \n";
   print_r($deque);
?>

输出

上述程序输出如下：

The deque elements are:
Ds\Deque Object
(
    [0] => 12
    [1] => 24
    [2] => 36
    [3] => 48
    [4] => 60
    [5] => 72
)
The given value: 72
The deque after adding new element:
Ds\Deque Object
(
    [0] => 72
    [1] => 12
    [2] => 24
    [3] => 36
    [4] => 48
    [5] => 60
    [6] => 72
)

示例 2

以下是 PHP Ds\Deque::unshift() 函数的另一个示例。我们使用此函数将值 'p' 和 'g' 添加到此双端队列 (['g', 'j', 'p', 'q', 'y']) 的头部：

<?php
   $deque = new \Ds\Deque(['g', 'j', 'p', 'q', 'y']);
   echo "The deque elements are: \n";
   print_r($deque);
   $val1 = 'p';
   $val2 = 'g';
   echo "The given values are: ".$val1.", ".$val2;
   #using unshift() function
   $deque->unshift($val1);
   $deque->unshift($val2);
   echo "\nThe deque after adding new values: \n";
   print_r($deque);
?>

输出

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

The deque elements are:
Ds\Deque Object
(
    [0] => g
    [1] => j
    [2] => p
    [3] => q
    [4] => y
)
The given values are: p, g
The deque after adding new values:
Ds\Deque Object
(
    [0] => g
    [1] => p
    [2] => g
    [3] => j
    [4] => p
    [5] => q
    [6] => y
)