PHP array_splice() 函數

PHP Array 函數

實例

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

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

運行實例

定義和用法

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

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

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

說明

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

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

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

語法

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

運行實例

例子 2

把 length 參數設置為 0：

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

運行實例

PHP Array 函數