array_chunk

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

array_chunk — Divide um array em pedaços

Descrição

array_chunk(array $array, int $length, bool $preserve_keys = false): array

Divide um array em pedaços com tamanho informado pelo parâmetro length. O último pedaço pode conter menos elementos que o parâmetro length.

Parâmetros

array: O array.
length: O tamanho de cada pedaço.
preserve_keys: Quando definido para true, as chaves serão preservadas. O padrão é false, que reindexará os pedaços numericamente.

Valor Retornado

Retorna um array multidimensional numericamente indexado, iniciando em 0, com cada dimensão contendo length elementos.

Erros/Exceções

Se length for menor que 1, será lançado um ValueError.

Registro de Alterações

Versão	Descrição
8.0.0	Se `length` for menor que `1`, agora um ValueError é lançado; antes, um erro de nível `E_WARNING` era emitido em vez de retornar `null`.

Exemplos

Exemplo #1 Exemplo de 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));
?>

O exemplo acima produzirá:

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
        )

)

Veja Também

array_slice() - Extrai uma parcela de um array