PHP array_splice() -Funktion

Beispiel

Elemente aus dem Array entfernen und durch neue Elemente ersetzen:

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

运行实例

Definition und Verwendung

Die array_splice() -Funktion entfernt Elemente aus dem Array und ersetzt sie durch neue Elemente. Diese Funktion gibt auch das Array mit den entfernten Elementen zurück.

Hinweis:Funktion ohne Entfernung von Elementen (length=0), wird von start Position des Parameters in das ausgetauschte Array einfügen (siehe Beispiel 2).

Anmerkung:Die Schlüsselnamen im ausgetauschten Array werden nicht beibehalten.

Beschreibung

Die array_splice() -Funktion ähnelt array_slice() Die Funktion ähnelt, wählt eine Reihe von Elementen aus dem Array aus, gibt sie jedoch nicht zurück, sondern löscht sie und ersetzt sie durch andere Werte.

Wird ein vierter Parameter bereitgestellt, werden die zuvor ausgewählten Elemente durch das Array ersetzt, das durch den vierten Parameter angegeben wird.

Das letztendlich generierte Array wird zurückgegeben.

Syntax

array_splice(array,start,length,array)
Parameter Beschreibung
array Erforderlich. Bestimmt das Array.
start

Erforderlich. Numerisch. Bestimmt den Startort der Entfernung des Elements.

  • 0 = erster Element.
  • Wenn der Wert auf einen positiven Wert gesetzt wird, wird ab dem angegebenen Abstand im Array entfernt.
  • Wenn der Wert auf einen negativen Wert gesetzt wird, werden ab dem Ende des Arrays aus, der der Wert angegebene Abstand entfernt.
  • -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);
?>

运行实例