array_chunk()‎

من موسوعة حسوب
< PHP

(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: مثال بسيط عن الدالة 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
        )

)

انظر أيضًا

المصادر