array_chunk
(PHP 4 >= 4.2.0, PHP 5, PHP 7)
array_chunk — 配列を分割する
説明
array_chunk
( array $array
, int $length
[, bool $preserve_keys
= false
] ) : array
配列を、要素数が length
の配列に分割します。
最後の部分の要素数は length
より小さくなることもあります。
パラメータ
array
- 処理を行う配列。
length
- 各部分のサイズ。
preserve_keys
true
の場合はキーをそのまま保持します。 デフォルトはfalse
で、各部分のキーをあらためて数字で振りなおします。
返り値
数値添字の多次元配列を返します。添え字はゼロから始まり、
各次元の要素数が length
となります。
エラー / 例外
length
が 1 より小さい場合は
E_WARNING
が発生し、null
を返します。
例
例1 array_chunk() の例
<?php$input_array = array('a', 'b', 'c', 'd', 'e');print_r(array_chunk($input_array, 2));print_r(array_chunk($input_array, 2, true));?>
上の例の出力は以下となります。
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 ) )