array_chunk

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

array_chunk — Splittet ein Array in Teile auf

Beschreibung

array_chunk(array $array, int $length, bool $preserve_keys = false): array

array_chunk() teilt das Array in Arrays mit length Elementen auf. Das letzte Array kann weniger als length Werte enthalten.

Parameter-Liste

array

Das Eingabe-Array

length

Die Größe der einzelnen Teile

preserve_keys

Falls auf true gesetzt, bleiben die Schlüssel erhalten. Der Standard ist false, wodurch jeder Teil neue numerische Indizes erhält.

Rückgabewerte

Gibt ein mehrdimensionales Array zurück, das beginnend mit Null jeweils length Elemente enthält.

Fehler/Exceptions

Wenn length kleiner ist als 1, wird ein ValueError ausgelöst.

Changelog

Version Beschreibung
8.0.0 Wenn length kleiner ist als 1, wird nun ein ValueError ausgelöst; vorher wurde ein Fehler der Stufe E_WARNING ausgelöst, und die Funktion gab null zurück.

Beispiele

Beispiel #1 array_chunk()-Beispiel

<?php
$input_array = array('a', 'b', 'c', 'd', 'e');
print_r(array_chunk($input_array, 2));
print_r(array_chunk($input_array, 2, true));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Array
(
    [0] => Array
        (
            [0] => a
            [1] => b
        )

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

    [2] => Array
        (
            [0] => e
        )

)
Array
(
    [0] => Array
        (
            [0] => a
            [1] => b
        )

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

    [2] => Array
        (
            [4] => e
        )

)

Siehe auch