PHP/array chunk
الدالة array_chunk()
(PHP 4 >= 4.2.0, PHP 5, PHP 7)
تقسم الدالة array_chunk() المصفوفة إلى أجزاء صغيرة.
الوصف
array array_chunk ( array $array , int $size [, bool $preserve_keys = FALSE ] )
تقسم هذه الدالة المصفوفة إلى مصفوفات أصغر كل منها يحتوي على عدد من العناصر يساوي قيمة المعامل $size. قد تحتوي المصفوفة الصغيرة الأخيرة على عددٍ من العناصر أقل من قيمة المعامل $size.
المعاملات
array
المصفوفة التي ستعمل عليها الدالة.
size
حجم كل مصفوفة جزئية مقتطعة من المصفوفة الأصلية.
preserve_keys
ستحافظ الدالة على المفاتيح في المصفوفات الصغيرة الناتجة إذا كانت قيمة هذا المعامل مساوية ل TRUE. القيمة الافتراضية لهذا المعامل هي FALSE ما سيؤدي إلى إعادة إنشاء مفاتيح جديدة لكل مصفوفة صغيرة ناتجة بعد التقسيم.
القيم المعادة
تعيد هذه الدالة مصفوفةً متعددةَ الأبعاد مرتبًة عدديًا، بدءًا من الصفر. ويحتوي كل بعدٍ من أبعاد المصفوفة على عددٍ من العناصر يساوي قيمة المعامل $size.
الأخطاء والاستثناءات
ترمي هذه الدالة خطأً من النوع E_WARNING إذا كان المعامل $size أصغر من 1 وستعيد الدالة NULL في تلك الحالة.
أمثلة
مثال رقم 1:
<?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
)
)
انظر أيضاً
- الدالة array_slice() تستخرج جزءاً من المصفوفة.