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，可以使 PHP 保留輸入陣列中原來的鍵名。如果你指定了false，那每個結果陣列將用從零開始的新數字索引。預設值是false。
返回值
得到的陣列是一個多維陣列中的單元，其索引從零開始，每一維包含了 length 個元素。
錯誤／異常
如果 length 小於 1，會拋出一個
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
)
)