(PHP 4, PHP 5, PHP 7)
array_splice — 把数组中的一部分去掉并用其它值取代
把 input
数组中由
offset
和 length
指定的单元去掉,如果提供了 replacement
参数,则用其中的单元取代。
注意
input
中的数字键名不被保留。
Note: If
replacement
is not an array, it will be typecast to one (i.e.(array) $parameter
). This may result in unexpected behavior when using an object orNULL
replacement
.
input
输入的数组。
offset
如果 offset
为正,则从 input
数组中该值指定的偏移量开始移除。如果 offset
为负,则从 input
末尾倒数该值指定的偏移量开始移除。
length
如果省略 length
,则移除数组中从 offset
到结尾的所有部分。如果指定了 length
并且为正值,则移除这么多单元。如果指定了 length
并且为负值,则移除从 offset
到数组末尾倒数
length
为止中间所有的单元。小窍门:当给出了
replacement
时要移除从 offset
到数组末尾所有单元时,用 count($input) 作为 length
。
replacement
如果给出了 replacement
数组,则被移除的单元被此数组中的单元替代。
如果
offset
和 length
的组合结果是不会移除任何值,则 replacement
数组中的单元将被插入到 offset
指定的位置。 注意替换数组中的键名不保留。
如果用来替换 replacement
只有一个单元,那么不需要给它加上
array(),除非该单元本身就是一个数组、一个对象或者 NULL
。
返回一个包含有被移除单元的数组。
Example #1 array_splice() 例子
<?php
$input = array("red", "green", "blue", "yellow");
array_splice($input, 2);
// $input is now array("red", "green")
$input = array("red", "green", "blue", "yellow");
array_splice($input, 1, -1);
// $input is now array("red", "yellow")
$input = array("red", "green", "blue", "yellow");
array_splice($input, 1, count($input), "orange");
// $input is now array("red", "orange")
$input = array("red", "green", "blue", "yellow");
array_splice($input, -1, 1, array("black", "maroon"));
// $input is now array("red", "green",
// "blue", "black", "maroon")
$input = array("red", "green", "blue", "yellow");
array_splice($input, 3, 0, "purple");
// $input is now array("red", "green",
// "blue", "purple", "yellow");
?>
Example #2 array_splice() 例子
以下表达式以同样方式修改了 $input:
<?php
array_push($input, $x, $y);
array_splice($input, count($input), 0, array($x, $y));
array_pop($input);
array_splice($input, -1);
array_shift($input);
array_splice($input, 0, 1);
array_unshift($input, $x, $y);
array_splice($input, 0, 0, array($x, $y));
$input[$x] = $y; // 对于键名和偏移量等值的数组
array_splice($input, $x, 1, $y);
?>