array_splice

名稱:array_splice

分類:數組

所屬語言:php

一句話介紹:刪除並替換數組中指定的元素。

定義和用法

array_splice()函數從數組中移除選定的元素，並用新元素取代它。該函數也將返回包含被移除元素的數組。

提示：如果函數沒有移除任何元素（length=0），則將從start參數的位置插入被替換數組（參見例子2）。

註釋：不保留被替換數組中的鍵名。

實例

例子1

從數組中移除元素，並用新元素取代它：

 <?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 ) ;
?>

親自試一試

例子2

與本頁前面部分的實例相同，但是輸出返回的數組：

 <?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 ) ) ;
?>

親自試一試

例子3

把length 參數設置為0：

 <?php
$a1 = array ( "0" => "red" , "1" => "green" ) ;
$a2 = array ( "0" => "purple" , "1" => "orange" ) ;
array_splice ( $a1 , 1 , 0 , $a2 ) ;
print_r ( $a1 ) ;
?>

親自試一試

文法

array_splice ( array , start , length , array )

參數	描述
array	必需。規定數組。
start	必需。數值。規定刪除元素的開始位置。 0 = 第一個元素。如果該值設置為正數，則從數組中該值指定的偏移量開始移除。如果該值設置為負數，則從數組末端倒數該值指定的偏移量開始移除。 -2 意味著從數組的倒數第二個元素開始。
length	可選。數值。規定被移除的元素個數，也是被返回數組的長度。如果該值設置為正數，則移除該數量的元素。如果該值設置為負數，則移除從start 到數組末端倒數length 為止中間所有的元素。如果該值未設置，則移除從start 參數設置的位置開始直到數組末端的所有元素。
array	可選。規定帶有要插入原始數組中元素的數組。如果只有一個元素，則可以設置為字符串，不需要設置為數組。