PHP - Ds Sequence::insert() 函式

PHP 的 Ds\Sequence::insert() 函式用於在序列的給定索引處插入值。“索引”是序列中元素的位置，從 0 開始，代表第一個元素，1 代表第二個元素，以此類推。

如果指定的索引“無效”（即負數或大於序列大小），此函式將丟擲“OutOfRangeException”異常。

語法

以下是 PHP Ds\Sequence::insert() 函式的語法：

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

引數

以下是此函式的引數：

• index - 需要插入值的索引。
• values - 要插入的一個或多個值。

返回值

此函式不返回值。

示例 1

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

<?php
   $seq = new \Ds\Vector([2, 3, 4, 5]);
   echo "The original sequence: \n";
   print_r($seq);
   $index = 0;
   $val = 1;
   echo "The given index is: ".$index;
   echo "\nThe given value is: ".$val;
   echo "\nThe sequence after insert: \n";
   #using insert() function
   $seq->insert($index, $val);
   print_r($seq);
?>

輸出

以上程式輸出如下：

The original sequence:
Ds\Vector Object
(
    [0] => 2
    [1] => 3
    [2] => 4
    [3] => 5
)
The given index is: 0
The given value is: 1
The sequence after insert:
Ds\Vector Object
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
)

示例 2

以下是 PHP Ds\Sequence::insert() 函式的另一個示例。我們使用此函式在此序列 ([]) 中指定索引處插入值：

<?php
   $seq = new \Ds\Vector([]);
   echo "The original sequence: \n";
   print_r($seq);
   $count = 0;
   for($i = 0; $i<=10; $i++){
	   $count += 1;
	   #using insert() function
	   $seq->insert($i, $count);
   }
   echo "The sequence after insert: \n";
   print_r($seq);
?>

輸出

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

The original sequence:
Ds\Vector Object
(
)
The sequence after insert:
Ds\Vector Object
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
    [5] => 6
    [6] => 7
    [7] => 8
    [8] => 9
    [9] => 10
    [10] => 11
)

示例 3

如果給定的索引無效（即負數），insert() 函式將丟擲“OutOfRangeException”異常，如下所示：

<?php
   $seq = new \Ds\Vector(['a', 'b', 'c']);
   echo "The original sequence: \n";
   print_r($seq);
   $index = -1;
   $val = 'a';
   echo "The given index is: ".$index;
   echo "\nThe given value is: ".$val;
   echo "\nThe sequence after insert: \n";
   #using insert() function
   $seq->insert($index, $val);
   print_r($seq);
?>

輸出

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

The original sequence:
Ds\Vector Object
(
    [0] => a
    [1] => b
    [2] => c
)
The given index is: -1
The given value is: a
The sequence after insert:
PHP Fatal error:  Uncaught OutOfRangeException: 
Index out of range: -1, expected 0 <= x <= 3 in C:\Apache24\htdocs\index.php:11
Stack trace:
#0 C:\Apache24\htdocs\index.php(11): Ds\Vector->insert(-1, 'a')
#1 {main}
  thrown in C:\Apache24\htdocs\index.php on line 11