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
)