array_slice

(PHP 4, PHP 5)

array_slice — Extrahiert einen Ausschnitt eines Arrays

Beschreibung

array array_slice ( array $array , int $offset [, int $length = NULL [, bool $preserve_keys = false ]] )

array_slice() liefert die mittels offset und length spezifizierte Sequenz von Elementen des Arrays array.

Parameter-Liste

array

Das Eingabe-Array.

offset

Ist offset nicht negativ, beginnt die Sequenz bei diesem Offset in dem array. Ist offset negativ, beginnt die Sequenz so viele Elemente vor dem Ende von array.

length

Ist length angegeben und positiv, enthält die Sequenz bis zu so viele Elemente. Wenn das Array kürzer als der length ist, dann werden nur die verfügbaren Array-Elemente vorhanden sein. Ist length angegeben und negativ, endet die Sequenz so viele Elemente vor dem Ende des Arrays. Wenn nicht angegeben, enthält die Sequenz alle Elemente von offset bis zum Ende von array.

preserve_keys

Beachten Sie, dass array_slice() standardmäßig numerische Schlüssel des Arrays zurücksetzt und neu vergibt. Sie können dieses Verhalten ändern, indem Sie preserve_keys auf TRUE setzen.

Rückgabewerte

Gibt den Ausschnitt zurück.

Changelog

Version Beschreibung
5.2.4 Der Standardwert des length Parameters wurde zu NULL geändert. Eine NULL length weist nun die Funktion an, die Länge des array zu verwenden. Vor dieser Version wurde eine NULL length als 0 interpretiert (nichts wird zurückgegeben).
5.0.2 Der optionale preserve_keys-Parameter wurde hinzugefügt.

Beispiele

Beispiel #1 array_slice()-Beispiele

<?php
$input = array("a", "b", "c", "d", "e");

$output = array_slice($input, 2);      // liefert "c", "d" und "e"
$output = array_slice($input, -2, 1);  // liefert "d"
$output = array_slice($input, 0, 3);   // liefert "a", "b" und "c"

// beachten Sie die Unterschiede in den Schlüsseln
print_r(array_slice($input, 2, -1));
print_r(array_slice($input, 2, -1, true));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Array
(
    [0] => c
    [1] => d
)
Array
(
    [2] => c
    [3] => d
)

Siehe auch

  • array_splice() - Entfernt einen Teil eines Arrays und ersetzt ihn durch etwas anderes
  • unset() - Löschen einer angegebenen Variablen
  • array_chunk() - Splittet ein Array in Teile auf