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, ключи оригинального массива будут сохранены. По умолчанию установлено в 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
        )

)

Смотрите также