الفرق بين المراجعتين لصفحة: «PHP/array fill»
< PHP
ط إضافة عنوان الصفحة والتصنيفات |
لا ملخص تعديل |
||
| سطر 2: | سطر 2: | ||
(PHP 4 >= 4.2.0, PHP 5, PHP 7) | (PHP 4 >= 4.2.0, PHP 5, PHP 7) | ||
تملأ الدالة array_fill_keys() المصفوفة بقيم محددة. | تملأ الدالة <code>array_fill_keys()</code> المصفوفة بقيم محددة. | ||
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
array array_fill ( int $start_index , int $num , mixed $value ) | array array_fill ( int $start_index , int $num , mixed $value ) | ||
</syntaxhighlight>تملأ الدالة array_fill_keys() عددًا من عناصر المصفوفة يساوي num بقيمة تساوي value بدءًا من الفهرس start_index. | </syntaxhighlight>تملأ الدالة <code>array_fill_keys()</code> عددًا من عناصر المصفوفة يساوي <code>num</code> بقيمة تساوي <code>value</code> بدءًا من الفهرس <code>start_index</code>. | ||
== المعاملات == | == المعاملات == | ||
=== <code>start_index</code> === | |||
الفهرس الأول من المصفوفة المعادة. | الفهرس الأول من المصفوفة المعادة. | ||
إذا كانت قيمة start_index سالبة، سيكون الفهرس الأول للمصفوفة المعادة مساويًا لقيمة start_index بينما ستبدأ قيم الفهارس التالية من الصفر. | إذا كانت قيمة <code>start_index</code> سالبة، سيكون الفهرس الأول للمصفوفة المعادة مساويًا لقيمة <code>start_index</code> بينما ستبدأ قيم الفهارس التالية من الصفر. | ||
num | === <code>num</code> === | ||
عدد العناصر التي ستملأها الدالة. يجب أن تكون قيمة <code>num</code> أكبر أو تساوي الصفر. | |||
عدد العناصر التي ستملأها الدالة. يجب أن تكون قيمة num أكبر أو تساوي الصفر. | |||
=== <code>value</code> === | |||
القيمة التي ستستخدمها الدالة في ملأ المصفوفة. | القيمة التي ستستخدمها الدالة في ملأ المصفوفة. | ||
| سطر 28: | سطر 26: | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
ترمي الدالة خطأً من النوع E_WARNING إذا كانت قيمة num أقل من الصفر. | ترمي الدالة خطأً من النوع <code>E_WARNING</code> إذا كانت قيمة <code>num</code> أقل من الصفر. | ||
== سجل التغيُرات == | == سجل التغيُرات == | ||
{| class="wikitable" | {| class="wikitable" | ||
!الإصدار | |||
!الوصف | |||
|- | |- | ||
|5.6.0 | |5.6.0 | ||
|قيمة num يمكن أن تساوي صفر. في السابق، قيمة num كانت يجب أن تزيد عن الصفر. | |أمست قيمة <code>num</code> يمكن أن تساوي صفر. في السابق، قيمة <code>num</code> كانت يجب أن تزيد عن الصفر. | ||
|} | |} | ||
== أمثلة == | == أمثلة == | ||
المثال 1: استخدام بسيط للدالة array_fill()<syntaxhighlight lang="php"> | المثال 1: استخدام بسيط للدالة <code>array_fill()</code><syntaxhighlight lang="php"> | ||
<?php | <?php | ||
$a = array_fill(5, 6, 'banana'); | $a = array_fill(5, 6, 'banana'); | ||
$b = array_fill(-2, 4, 'pear'); | $b = array_fill(-2, 4, 'pear'); | ||
print_r($a); | print_r($a); | ||
print_r($b); | print_r($b); | ||
?> | |||
</syntaxhighlight> | </syntaxhighlight> | ||
نتيجة المثال السابق:<syntaxhighlight lang="php"> | نتيجة المثال السابق:<syntaxhighlight lang="php"> | ||
Array | Array | ||
( | ( | ||
[5] => banana | |||
[6] => banana | |||
[7] => banana | |||
[8] => banana | |||
[9] => banana | |||
[10] => banana | |||
) | ) | ||
Array | Array | ||
( | ( | ||
[-2] => pear | |||
[0] => pear | |||
[1] => pear | |||
[2] => pear | |||
) | ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== ملاحظات == | == ملاحظات == | ||
انظر أيضاً إلى قسم Arrays في توثيق PHP الرسمي لشرحٍ تفصيلي عن المفاتيح السالبة. | انظر أيضاً إلى قسم [[PHP/Types/array|Arrays]] في توثيق PHP الرسمي لشرحٍ تفصيلي عن المفاتيح السالبة. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة array_fill_keys(): تملأ المصفوفة بقيمة محددة مع تحديد المفاتيح المستخدمة. | * الدالة <code>[[PHP/Function/array-fill-keys|array_fill_keys()]]</code>: تملأ المصفوفة بقيمة محددة مع تحديد المفاتيح المستخدمة. | ||
* الدالة str_repeat(): تكرر النصوص. | * الدالة <code>[[PHP/Function/str-repeat|str_repeat()]]</code>: تكرر النصوص. | ||
* الدالة range(): تنشئ مصفوفةً جديدةً تحتوي على مجال من القيم. | * الدالة <code>[[PHP/Function/range|range()]]</code>: تنشئ مصفوفةً جديدةً تحتوي على مجال من القيم. | ||
== مصادر == | == مصادر == | ||
مراجعة 05:11، 14 مارس 2018
(PHP 4 >= 4.2.0, PHP 5, PHP 7)
تملأ الدالة array_fill_keys() المصفوفة بقيم محددة.
الوصف
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(): تنشئ مصفوفةً جديدةً تحتوي على مجال من القيم.