PHP array_splice() 函數
實例
從數組中移除元素，並用新元素取代它：
<?php
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");
$a2=array("a"=>"purple","b"=>"orange");
array_splice($a1,0,2,$a2);
print_r($a1);
?>
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");
$a2=array("a"=>"purple","b"=>"orange");
array_splice($a1,0,2,$a2);
print_r($a1);
?>
運行實例»
定義和用法
array_splice() 函數從數組中移除選定的元素，並用新元素取代它。 函數也將返回被移除元素的數組。
提示：如果函數沒有移除任何元素（length=0），則替代數組將從start參數的位置插入（參見實例2）。
註釋：不保留替代數組中的鍵名。
語法
array_splice( array,start,length,array )
| 参数 | 描述 |
|---|---|
| array | 必需。规定数组。 |
| start | 必需。数值。规定删除元素的开始位置。
0 = 第一个元素。
如果该值设置为正数，则从数组中该值指定的偏移量开始移除。如果该值设置为负数，则从数组末端倒数该值指定的偏移量开始移除。
-2 意味着从数组的倒数第二个元素开始。 |
| length | 可选。数值。规定被移除的元素个数，也是被返回数组的长度。
如果该值设置为正数，则移除该数量的元素。如果该值设置为负数，则移除从 start 到数组末端倒数 length 为止中间所有的元素。如果该值未设置，则移除从 start 参数设置的位置开始直到数组末端的所有元素。
|
| array | 可选。规定带有要插入原始数组中元素的数组。如果只有一个元素，则可以设置为字符串，不需要设置为数组。 |
技術細節
| 返回值： | 返回包含被提取元素的數組。 |
|---|---|
| PHP 版本： | 4+ |
更多實例
實例1
與本頁前面部分的實例相同，但是輸出返回的數組：
<?php
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");
$a2=array("a"=>"purple","b"=>"orange");
print_r(array_splice($a1,0,2,$a2));
?>
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");
$a2=array("a"=>"purple","b"=>"orange");
print_r(array_splice($a1,0,2,$a2));
?>
運行實例»
實例2
帶有設置為0 的length 參數：
<?php
$a1=array("0"=>"red","1"=>"green");
$a2=array("0"=>"purple","1"=>"orange");
array_splice($a1,1,0,$a2);
print_r($a1);
?>
$a1=array("0"=>"red","1"=>"green");
$a2=array("0"=>"purple","1"=>"orange");
array_splice($a1,1,0,$a2);
print_r($a1);
?>
運行實例»
完整的PHP Array參考手冊