array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.array-chunk.php', 1 => 'array_chunk', 2 => 'Разбивает массив на части', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Функции для работы с массивами', ), 'prev' => array ( 0 => 'function.array-change-key-case.php', 1 => 'array_change_key_case', ), 'next' => array ( 0 => 'function.array-column.php', 1 => 'array_column', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/array/functions/array-chunk.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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
        )

)

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