array_splice

定義和用法

array_splice() 函式與 array_slice() 函式類似，選擇數組中的一系列元素，但不返回，而是刪除它們並用其它值代替。

如果提供了第四個參數，則之前選中的那些元素將被第四個參數指定的數組取代。

最後生成的數組將會返回。

語法

array_splice(array,offset,length,array)

參數	描述
array	必需。規定數組。
offset	必需。數值。如果 offset 為正，則從輸入數組中該值指定的偏移量開始移除。如果 offset 為負，則從輸入數組末尾倒數該值指定的偏移量開始移除。
length	可選。數值。如果省略該參數，則移除數組中從 offset 到 結尾的所有部分。如果指定了 length 並且為正值，則移除這么多元素。如果指定了 length 且為負值，則移除從 offset 到數組末尾倒數 length 為止中間所有的元素。
array	被移除的元素由此數組中的元素替代。如果沒有移除任何值，則此數組中的元素將插入到指定位置。

提示和注釋

提示：如果函式沒有刪除任何元素 (length=0)，則替代數組將從 start 參數的位置插入。（參見例子 3）

注釋：不保留替代數組中的鍵。

例子

例子 1

<?php

$a1=array(0=>"Dog",1=>"Cat",2=>"Horse",3=>"Bird");

$a2=array(0=>"Tiger",1=>"Lion");

array_splice($a1,0,2,$a2);

print_r($a1);

?>

輸出：Array ( [0] => Tiger [1] => Lion [2] => Horse [3] => Bird )

例子 2

與例子 1 相同，但是輸出返回的數組：

<?php

$a1=array(0=>"Dog",1=>"Cat",2=>"Horse",3=>"Bird");

$a2=array(0=>"Tiger",1=>"Lion");

print_r(array_splice($a1,0,2,$a2));

?>

輸出：Array ( [0] => Dog [1] => Cat )

例子 3

length 參數設定為 0：

<?php

$a1=array(0=>"Dog",1=>"Cat");

$a2=array(0=>"Tiger",1=>"Lion");

array_splice($a1,1,0,$a2);

print_r($a1);

?>

輸出：Array ( [0] => Dog [1] => Tiger [2] => Lion [3] => Cat )