php array_splice PHP array_splice() 函数

php array_splice

PHP array_splice 函数用于从数组中删除选定的元素，并用新元素替换它们。它可以用来在数组中插入、删除和替换元素。

array_splice() 函数的语法如下：

array_splice ( array &$input , int $offset [, int $length = 0 [, mixed $replacement = array() ]] )

参数说明：

• input: 必需。规定要处理的数组。
• offset: 必需。规定开始插入或删除的位置（即下标或关联键名）。如果是负值，则表示偏移量是从末尾开始计算的。
• length: 可选。规定要删除的元素个数。如果未规定此参数，则会从 offset 到末尾进行删除。
• replacement: 可选。规定要在原来位置上插入的新元素（可以是一个或多个）。

array_splice()函数返回一个包含所有被删除元素的新数组，如果只是想要修剪或者去除一部分元素而不想保留返回值时，可以将返回值舍弃不用即可。

PHP array_splice() 函数

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,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

带有设置为 0 的 length 参数：

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

运行实例 »

---

完整的 PHP Array 参考手册