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

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

    To Top