PHP - Ds Sequence::unshift() 函数

PHP 的 Ds\Sequence::unshift() 函数用于向序列的开头添加值。

此函数允许您一次向序列的开头添加多个值，方法是将所有值向前移动以腾出空间以容纳新添加的值。

语法

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

public abstract void Ds\Sequence::unshift([ mixed $values ] )

参数

以下是此函数的参数：

• values − 需要添加到序列开头的单个或多个值。

返回值

此函数不返回值。

示例 1

以下程序演示了 PHP Ds\Sequence::unshift() 函数的用法：

<?php
   $seq = new \Ds\Vector([1, 2, 3]);
   echo "The sequence elements are: \n";
   print_r($seq);
   $val = 0;
   echo "The given value: ".$val;
   $seq->unshift($val);
   echo "\nThe sequence after unshift elements: \n";
   print_r($seq);
?>

输出

以上程序产生以下输出：

The sequence elements are:
Ds\Vector Object
(
    [0] => 1
    [1] => 2
    [2] => 3
)
The given value: 0
The sequence after unshift elements:
Ds\Vector Object
(
    [0] => 0
    [1] => 1
    [2] => 2
    [3] => 3
)

示例 2

一次在序列前面添加多个值。

以下是 PHP Ds\Sequence::unshift() 函数的另一个示例。我们使用此函数在该向量的开头添加指定的元素 'c'、'd' 和 'e' (['a', 'b'])：

<?php
   $seq = new \Ds\Vector(['a', 'b']);
   echo "The sequence elements are: \n";
   print_r($seq);
   $val1 = 'c';
   $val2 = 'd';
   $val3 = 'e';
   echo "The given values are: ".$val1.", ".$val2.", ".$val3;
   $seq->unshift($val1, $val2, $val3);
   echo "\nThe sequence after unshift elements: \n";
   print_r($seq);
?>

输出

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

The sequence elements are:
Ds\Vector Object
(
    [0] => a
    [1] => b
)
The given values are: c, d, e
The sequence after unshift elements:
Ds\Vector Object
(
    [0] => c
    [1] => d
    [2] => e
    [3] => a
    [4] => b
)