(PHP 4, PHP 5)
array_slice — Extrahiert einen Ausschnitt eines Arrays
$array
, int $offset
[, int $length
[, bool $preserve_keys
= false
]] )
array_slice() liefert die mittels
offset
und length
spezifizierte Sequenz von Elementen des Arrays
array
.
Hinweis: Diese Funktion setzt ( reset()) nach Verwendung den array-Zeiger zurück.
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 genauso viele Elemente. 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 Schlüssel des Arrays zurücksetzt und neu vergibt.
Sie können dieses Verhalten ändern, indem Sie
preserve_keys
auf TRUE
setzen.
Gibt den Ausschnitt zurück.
Version | Beschreibung |
---|---|
5.0.2 |
Der optionale preserve_keys -Parameter
wurde hinzugefügt.
|
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 )