الفرق بين المراجعتين لصفحة: «PHP/array fill»
< PHP
Ibrahem-atef (نقاش | مساهمات) إنشاء صفحة جديدة |
ط نقل عبد اللطيف ايمش صفحة PHP/Function/array-fill إلى PHP/array fill: إعادة هيكلة التوثيق |
||
| (8 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:<code>array_fill()</code>}}</noinclude> | |||
(PHP 4 >= 4.2.0, PHP 5, PHP 7) | |||
تملأ الدالة <code>array_fill()</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/array|Arrays]] في توثيق PHP الرسمي لشرحٍ تفصيلي عن المفاتيح السالبة. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة array_fill_keys(): تملأ المصفوفة بقيمة محددة مع تحديد المفاتيح المستخدمة. | * الدالة <code>[[PHP/array_fill_keys|array_fill_keys()]]</code>: تملأ المصفوفة بقيمة محددة مع تحديد المفاتيح المستخدمة. | ||
* الدالة str_repeat(): تكرر النصوص. | * الدالة <code>[[PHP/str_repeat|str_repeat()]]</code>: تكرر النصوص. | ||
* الدالة range(): تنشئ مصفوفةً جديدةً تحتوي على مجال من القيم. | * الدالة <code>[[PHP/range|range()]]</code>: تنشئ مصفوفةً جديدةً تحتوي على مجال من القيم. | ||
== مصادر == | == مصادر == | ||
* [http://php.net/manual/en/function.array-fill.php صفحة الدالة array_fill في توثيق PHP الرسمي.] | * [http://php.net/manual/en/function.array-fill.php صفحة الدالة array_fill في توثيق PHP الرسمي.] | ||
[[تصنيف:PHP]] | |||
[[تصنيف:PHP Function]] | |||
[[تصنيف:PHP Array]] | |||
المراجعة الحالية بتاريخ 03:49، 4 أبريل 2018
(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(): تنشئ مصفوفةً جديدةً تحتوي على مجال من القيم.