array_fill()
< PHP
(PHP 4 >= 4.2.0, PHP 5, PHP 7)
تملأ الدالة array_fill() المصفوفة بقيم محددة.
الوصف
array array_fill ( int $start_index , int $num , mixed $value )
تملأ الدالة array_fill_keys() عددًا من عناصر المصفوفة يساوي num بقيمة تساوي value بدءًا من الفهرس start_index.
المعاملات
start_index
الفهرس الأول من المصفوفة المعادة.
إذا كانت قيمة start_index سالبة، سيكون الفهرس الأول للمصفوفة المعادة مساويًا لقيمة start_index بينما ستبدأ قيم الفهارس التالية من الصفر.
num
عدد العناصر التي ستملأها الدالة. يجب أن تكون قيمة num أكبر أو تساوي الصفر.
value
القيمة التي ستستخدمها الدالة في ملأ المصفوفة.
القيم المعادة
تعيد المصفوفة الممتلئة بالقيمة المحددة.
الأخطاء والاستثناءات
ترمي الدالة خطأً من النوع E_WARNING إذا كانت قيمة num أقل من الصفر.
سجل التغيُرات
| الإصدار | الوصف |
|---|---|
| 5.6.0 | أمست قيمة num يمكن أن تساوي صفر. في السابق، قيمة num كانت يجب أن تزيد عن الصفر.
|
أمثلة
المثال 1: استخدام بسيط للدالة array_fill()
<?php
$a = array_fill(5, 6, 'banana');
$b = array_fill(-2, 4, 'pear');
print_r($a);
print_r($b);
?>
نتيجة المثال السابق:
Array
(
[5] => banana
[6] => banana
[7] => banana
[8] => banana
[9] => banana
[10] => banana
)
Array
(
[-2] => pear
[0] => pear
[1] => pear
[2] => pear
)
ملاحظات
انظر أيضاً إلى قسم Arrays في توثيق PHP الرسمي لشرحٍ تفصيلي عن المفاتيح السالبة.
انظر أيضًا
- الدالة
array_fill_keys(): تملأ المصفوفة بقيمة محددة مع تحديد المفاتيح المستخدمة. - الدالة
str_repeat(): تكرر النصوص. - الدالة
range(): تنشئ مصفوفةً جديدةً تحتوي على مجال من القيم.