array_chunk
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_chunk — Splittet ein Array in Teile auf
Beschreibung
$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 istfalse
, 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 ) )