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

Name	Beschreibung
input	Das Eingabe-Array.
offset	Ist offset positiv, beginnt der zu entfernende Bereich bei diesem Offset vom Anfang des Arrays input. Ist offset negativ, beginnt der zu entfernende Bereich so viele Elemente vor dem Ende des Arrays input.
length	Ist length nicht angegeben, wird alles von offset bis zum Ende des Arrays entfernt. Ist length angegeben und positiv, werden so viele Elemente entfernt. Ist length angegeben und negativ, so ist das Ende des entfernten Bereichs so viele Elemente vor dem Ende des Array. Tipp: Um alles von offset bis zum Ende des Arrays zu entfernen, wenn replacement ebenfalls angegeben ist, verwenden Sie count($input) als length.
replacement	Ist das Array replacement angegeben, werden die entfernten Elemente durch die Elemente dieses Arrays ersetzt. Sind offset und length so angegeben, dass nichts entfernt wird, werden die Elemente von replacement an der von offset spezifizierten Stelle eingefügt. Beachten Sie, dass Schlüssel bei der Ersetzung nicht erhalten werden. Wenn replacement nur aus einem Element besteht, ist es nicht notwendig, array() anzugeben, sofern das Element nicht selbst ein Array, ein Objekt odr NULL ist.

Gibt ein Array zurück, das aus den ausgeschnittenen Elementen besteht.

Die Funktion array_splice() ersetzt oder entfernt einen Teilbereich aus einem Array (input). Der Teilbereich ist definiert durch den Index des ersten Elements(offset) und die Anzahl der Elemente (length, Default-Wert sind alle Elemente bis zum Ende des Arrays).

Enthält der Parameter replacement ein Array, fügt die Funktion dieses Array an der Stelle ein, wo sie die gewünschten Elemente entfernt hat.

Der Rückgabewert enthält jetzt die ersetzten Werte aus dem Ursprungs-Array (input).

Der Parameter offset gibt den Index des Startelements an. Ist offset positiv, so wird vom Anfang des Arrays gezählt. Ist offset hingegen negativ, so wird vom Ende des Arrays gezählt.

(PHP 4, PHP 5, PHP 7)

<?PHP
$array1 = array ( 'Katze', 'Maus', 'Igel', 'Pferd', 'Huhn' );

$array2 = array_splice ( $array1, 1, -2 );

print_r ( $array1 );
?>

<?PHP
$array1 = array ( 'Katze', 'Maus', 'Igel', 'Pferd', 'Huhn' );

$array2 = array_splice ( $array1, 3 );

print_r ( $array1 );
?>

<?PHP
$array1 = array ( 'Katze', 'Maus', 'Igel', 'Pferd', 'Huhn' );

$array2 = array_splice ( $array1, 2, count ( $array1 ), 'Huhn');

print_r ( $array1 );
?>

<?PHP
$array1 = array( 'Katze', 'Maus', 'Igel', 'Pferd', 'Huhn' );

$array = array( 'Wal', 'Hai' );

$array2 = array_splice( $array1, -2, 2, $array );

print_r ( $array1 );

print_r ( $array2 );
?>