عرض مصدر PHP/array chunk

<noinclude>{{DISPLAYTITLE:<code>array_chunk()‎</code>}}</noinclude>
(PHP 4 >= 4.2.0, PHP 5, PHP 7)

تقسم الدالة array_chunk()‎ المصفوفة إلى أجزاء صغيرة. 

== الوصف ==
<syntaxhighlight lang="php">
array array_chunk ( array $array , int $size [, bool $preserve_keys = FALSE ] )
</syntaxhighlight>

تقسم هذه الدالة المصفوفة إلى مصفوفات أصغر كل منها يحتوي على عدد من العناصر يساوي قيمة المعامل ‎$size. قد تحتوي المصفوفة الصغيرة الأخيرة على عددٍ من العناصر أقل من قيمة المعامل ‎$size. 

== المعاملات ==
array

المصفوفة التي ستعمل عليها الدالة.

size

حجم كل مصفوفة جزئية مقتطعة من المصفوفة الأصلية.

preserve_keys

ستحافظ الدالة على المفاتيح في المصفوفات الصغيرة الناتجة إذا كانت قيمة هذا المعامل مساوية ل TRUE. القيمة الافتراضية لهذا المعامل هي FALSE ما سيؤدي إلى إعادة إنشاء مفاتيح جديدة لكل مصفوفة صغيرة ناتجة بعد التقسيم. 

== القيم المعادة ==
تعيد هذه الدالة مصفوفةً متعددةَ الأبعاد مرتبًة عدديًا، بدءًا من الصفر. ويحتوي كل بعدٍ من أبعاد المصفوفة على عددٍ من العناصر يساوي قيمة المعامل ‎$size. 

== الأخطاء والاستثناءات ==
ترمي هذه الدالة خطأً من النوع E_WARNING إذا كان المعامل ‎$size أصغر من 1 وستعيد الدالة NULL في تلك الحالة. 

== أمثلة ==
مثال رقم 1:<syntaxhighlight lang="php">
<?php

$input_array = array('a', 'b', 'c', 'd', 'e');

print_r(array_chunk($input_array, 2));

print_r(array_chunk($input_array, 2, true));

?>
</syntaxhighlight>نتيجة المثال السابق:<syntaxhighlight lang="php">
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

       )

)
</syntaxhighlight>

== انظر أيضاً ==
* الدالة array_slice()‎ تستخرج جزءاً من المصفوفة.

== المصادر ==
* [http://php.net/manual/en/function.array-chunk.php صفحة array_chunk من توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Array]]