الفرق بين المراجعتين لصفحة: «PHP/array pad»
Khaled-yassin (نقاش | مساهمات) أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:<code>array_pad()</code>}}</noinclude> (PHP 4, PHP 5, PHP 7) تملأ الدالة <code>array_pad()</code> المصفوفة بعناص...' |
ط نقل عبد اللطيف ايمش صفحة PHP/Function/array-pad إلى PHP/array pad: إعادة هيكلة التوثيق |
||
| (5 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 18: | سطر 18: | ||
=== <code>value</code> === | === <code>value</code> === | ||
القيمة التي ستملأ المصفوفة إذا كان طول المصفوفة array أقل من الحجم size . | القيمة التي ستملأ المصفوفة إذا كان طول المصفوفة <code>array</code> أقل من الحجم <code>size</code> . | ||
== القيم المعادة == | == القيم المعادة == | ||
| سطر 37: | سطر 37: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <code>[[PHP/ | * الدالة <code>[[PHP/array_fill|array_fill()]]</code> : ملء مصفوفة بالقيم. | ||
* الدالة <code>[[PHP | * الدالة <code>[[PHP/range|range()]]</code> : إنشاء مصفوفة تحتوي على مجال من القيم. | ||
== مصادر == | == مصادر == | ||
* [http://php.net/manual/en/function.array-pad.php صفحة الدالة | * [http://php.net/manual/en/function.array-pad.php صفحة الدالة array_pad في توثيق PHP الرسمي.] | ||
[[تصنيف:PHP]] | [[تصنيف:PHP]] | ||
[[تصنيف:PHP Function]] | [[تصنيف:PHP Function]] | ||
[[تصنيف:PHP Array]] | [[تصنيف:PHP Array]] | ||
المراجعة الحالية بتاريخ 03:49، 4 أبريل 2018
(PHP 4, PHP 5, PHP 7)
تملأ الدالة array_pad() المصفوفة بعناصر بقيمة ما لتبلغ الطول المحدد.
الوصف
array array_pad ( array $array , int $size , mixed $value )
تُعيد دالة array_pad() نسخةً من المصفوفة array مملوءةً بعناصر بالقيمة value لتصبح بالحجم المحدد size. إذا كان الحجم size موجبًا، فسوف تمتلئ المصفوفة من جهة اليمين، أما إذا كان سالبًا فيكون ذلك من جهة اليسار. أما إذا كانت القيمة المطلقة لـلحجم size أقل من طول المصفوفة array أو مساوية له، فلن يكون هناك أي زيادة في الحجم. من الممكن إضافة 1048576 عنصر كحد أقصى في كل مرة.
المعاملات
array
مصفوفة القيم الأصلية المراد ملؤها.
size
الحجم الجديد للمصفوفة.
value
القيمة التي ستملأ المصفوفة إذا كان طول المصفوفة array أقل من الحجم size .
القيم المعادة
تُعيد دالة array_pad() نسخةً من المصفوفة array مملوءة بعناصر لها القيمة value لتصبح بالحجم المحدد size. إذا كان الحجم size موجبًا، فسوف تمتلئ المصفوفة من جهة اليمين، أما إذا كان سالبًا فيكون ذلك من جهة اليسار. أما إذا كانت القيمة المطلقة لـلحجم size أقل من طول المصفوفة array أو مساويةً له، فلن يكون هناك أي زيادة في الحجم.
أمثلة
المثال 1: مثال على الدالة array_pad()
<?php
$input = array(12, 10, 9);
$result = array_pad($input, 5, 0);
// المصفوفة الناتجة array(12, 10, 9, 0, 0)
$result = array_pad($input, -7, -1);
// المصفوفة الناتجة array(-1, -1, -1, -1, 12, 10, 9)
$result = array_pad($input, 2, "noop");
// بدون زيادة
?>
انظر أيضًا
- الدالة
array_fill() : ملء مصفوفة بالقيم. - الدالة
range() : إنشاء مصفوفة تحتوي على مجال من القيم.