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
truegesetzt, 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
)
)

