استخدام دالة PHP array_chunk() و مثال

وظائف Array في PHP

التعريف والاستخدام

array_chunk()يقوم هذا الدالة بتقسيم مجموعة من المعلومات إلى قطع أصغر بناءً على حجم المجموعة المحدد. قد تحتوي آخر قطعة على عدد أقل من العناصر مقارنة بالحجم المحدد بناءً على عدد المعلومات المتاحة في المجموعة.

النحو

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

المعامل

القيمة المرتجعة

PHP array_chunk() function returns a multidimensional array with zero-based numeric indices, where each dimension contains size elements.

إصدار PHP

تم إدخال هذه الوظيفة في إصدار PHP 4.2.0.

خطأ/استثنائية

إذا تم تمريرsizeأقل من 1، سيتم إطلاقE_WARNING، وتعود NULL.

مثال عبر الإنترنت

لنحاول مثالاً بسيطاً، نقسم المصفوفة إلى عدة قطع، كل قطعة تحتوي على 2 عنصر

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

سيتم إنتاج ما يلي، لنلاحظ مؤشرات كل مصفوفة أصغر، حيث تبدأ جميع الثلاثة قطع من الصفر

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

مثال عبر الإنترنت

لنحاول نفس المثال مرة أخرى، لكن هذه المرة سنقوم بتعيينpreserve_keysعند تعيينه كـ

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

سيتم إنتاج ما يلي، حيث يحتفظ كل عنصر بما كان يعتمد عليه من أرقام المؤشرات كالمصفوفة الأصلية

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

مثال عبر الإنترنت

في هذا المثال، تم تمرير قيمة 0 لمعامل size، مما أدى إلى إرسال رسالة تحذير

<?php
　　　//تحديد التقسيم إلى مصفوفة حجمها 0 سينتج عنه خطأ
　　　$input = array('abc', 'bcd', 'cde', 'def', 'efg');
　　　print_r(array_chunk($input, 0));
?>

نتائج الإخراج

PHP تنبيه: Size parameter expected to be greater than 0 in main.php on line 3

وظائف Array في PHP