Uso e Exemplos do PHP array_chunk()

Funções de Array PHP

Definição e Uso

array_chunk()A função divide um array em menores pedaços de tamanho especificado. Dependendo do múltiplo do número total disponível no array, o último bloco pode conter menos elementos do que o tamanho passado.

Sintaxe

array array_chunk ( array $input, int $size [, bool $preserve_keys] );

Parâmetros

Retorno

A função PHP array_chunk() retorna um array multidimensional de índices numéricos de zero, onde cada dimensão contém size elementos.

Versão do PHP

A função original foi introduzida na versão4.2introduzido em .0.

erro/exceção

Se passadosizemenor que1Se passadoE_WARNINGe retorna NULL.

Exemplo Online

Vamos tentar um exemplo simples, dividir um array em múltiplos pedaços, onde cada pedaço tem2de elementos-

<?php
　　　$input = array('abc', 'bcd', 'cde', 'def', 'efg');
　　　print_r(array_chunk($input,　2));
?>

Isso produzirá o seguinte resultado, observe os índices de cada subarray, todos três começam com zero-

Array
(
　　　　[0] => Array
　　　　　　　　(
　　　　　　　　　　　　[0] => abc
　　　　　　　　　　　　[1] => bcd
　　　　　　　　)
　　　　[1] => Array
　　　　　　　　(
　　　　　　　　　　　　[0] => cde
　　　　　　　　　　　　[1] => def
　　　　　　　　)
　　　　[2] => Array
　　　　　　　　(
　　　　　　　　　　　　[0] => efg
　　　　　　　　)
)

Exemplo Online

Vamos tentar novamente o mesmo exemplo, mas desta vez vamos passar o parâmetropreserve_keysDefinido como true:

<?php
　　　$input = array('abc', 'bcd', 'cde', 'def', 'efg');
　　　print_r(array_chunk($input,　2, true));
?>

Isso produzirá o seguinte resultado, desta vez cada elemento preserva seu índice como se fosse o array original-

Array
(
　　　　[0] => Array
　　　　　　　　(
　　　　　　　　　　　　[0] => abc
　　　　　　　　　　　　[1] => bcd
　　　　　　　　)
　　　　[1] => Array
　　　　　　　　(
　　　　　　　　　　　　[2] => cde
　　　　　　　　　　　　[3] => def
　　　　　　　　)
　　　　[2] => Array
　　　　　　　　(
　　　　　　　　　　　　[4] => efg
　　　　　　　　)
)

Exemplo Online

O exemplo a seguir passa o valor 0 para o parâmetro size, resultando em uma mensagem de aviso-

<?php
　　　//Especificar a divisão de um array de tamanho 0 lançará um erro
　　　$input = array('abc', 'bcd', 'cde', 'def', 'efg');
　　　print_r(array_chunk($input, 0));
?>

Resultados de Saída

PHP Avisos: array_chunk(): O parâmetro Size deve ser maior que 0 em main.php na linha　3

Funções de Array PHP