(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_chunk — 将一个数组分割成多个
$array
, int $length
, bool $preserve_keys
= false
): array
将一个数组分割成多个数组,其中每个数组的单元数目由
length
决定。最后一个数组的单元数目可能会少于 length
个。
array
需要操作的数组
length
每个数组的单元数目
preserve_keys
设为 true
,可以使 PHP
保留输入数组中原来的键名。如果你指定了 false
,那每个结果数组将用从零开始的新数字索引。默认值是 false
。
得到的数组是一个多维数组中的单元,其索引从零开始,每一维包含了 length
个元素。
如果 length
小于 1
,会抛出 ValueError。
版本 | 说明 |
---|---|
8.0.0 |
如果 length 小于 1 ,现在会抛出
ValueError;之前会引发 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 ) )