array_splice
(PHP 4, PHP 5, PHP 7)
array_splice — 去掉数组中的某一部分并用其它值取代
说明
&$input
, int $offset
[, int $length = count($input)
[, mixed $replacement = array()
]] ) : array
把 input 数组中由
offset 和 length
指定的单元去掉，如果提供了 replacement 参数，则用其中的单元取代。
注意
input 中的数字键名不被保留。
Note: 如果
replacement不是数组，会被 类型转换 成数组 (例如：(array) $replacement)。 当传入的replacement是个对象或者NULL，会导致未知的行为出现。
参数
-
input -
输入的数组。
-
offset -
如果
offset为正，则从input数组中该值指定的偏移量开始移除。如果offset为负，则从input末尾倒数该值指定的偏移量开始移除。 -
length -
如果省略
length，则移除数组中从offset到结尾的所有部分。如果指定了length并且为正值，则移除这么多单元。如果指定了length并且为负值，则移除从offset到数组末尾倒数length为止中间所有的单元。 如果设置了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
// 添加两个新元素到 $input
array_push($input, $x, $y);
array_splice($input, count($input), 0, array($x, $y));
// 移除 $input 中的最后一个元素
array_pop($input);
array_splice($input, -1);
// 移除 $input 中第一个元素
array_shift($input);
array_splice($input, 0, 1);
// 在 $input 的开头插入一个元素
array_unshift($input, $x, $y);
array_splice($input, 0, 0, array($x, $y));
// 在 $input 的索引 $x 处替换值
$input[$x] = $y; // 对于键名和偏移量等值的数组
array_splice($input, $x, 1, $y);
?>