Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

array_slice

Array-Funktionen

    Befehl:
array array_slice ( array $array, int $offset [, int $length [, bool $preserve_keys]] )


    Parameter-Liste:
NameBeschreibung
arrayDas Eingabe-Array.
offsetIst 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.
lengthIst 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_keysBeachten 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.

    Rückgabewerte:
Gibt den Ausschnitt zurück.

    Beschreibung:
Die Funktion array_slice() extrahiert einen Teilbereich aus einem Array (array). Dabei gibt offset den Index des Startelements an (Achtung: Ein Array beginnt bei 0) und length die Anzahl der Elemente.

Ist offset positiv, so wird vom Anfang des Arrays gezählt. Ist offset hingegen negativ, so wird vom Ende des Arrays gezählt.

Sollte length über das Ende des Arrays hinausweisen, so wird nur die Menge des Arrays bis zum Ende ausgegeben – es kommt zu keinem Fehler.


    Aktiv in Version:
(PHP 4, PHP 5, PHP 7)

    Siehe auch:
Entfernt einen Teil eines Arrays und ersetzt ihn durch etwas anderes
 
•  unset()
Löschen einer angegebenen Variablen
 

array_slice() - Beispiel:


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


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

Beschreibung:
Version Beschreibung
5.0.2 Der optionale preserve_keys-Parameter wurde hinzugefügt.
array_slice() - Beispiel 2:


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

$array2 = array_slice ( $array1, 2, 3 );

print_r ( $array2 );
?>


Ausgabe:
Array
(
    [0] => Igel
    [1] => Pferd
    [2] => Huhn
)

Beschreibung:
Version Beschreibung
5.0.2 Der optionale preserve_keys-Parameter wurde hinzugefügt.
array_slice() - Beispiel 3:


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

$array2 = array_slice ( $array1, -2, 3 );

print_r ( $array2 );
?>


Ausgabe:
Array
(
    [0] => Pferd
    [1] => Huhn
)

Beschreibung:
Version Beschreibung
5.0.2 Der optionale preserve_keys-Parameter wurde hinzugefügt.
Array-Funktionen