array_chunk

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

array_chunk — 将一个数组分割成多个

说明

array_chunk(array $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
        )

)

参见