الفرق بين المراجعتين ل"PHP/array pad"
ط (استبدال النص - 'PHP/Function/array' ب'PHP/array') |
|||
سطر 37: | سطر 37: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
− | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/array-fill|array_fill()]]</code> : ملء مصفوفة بالقيم. |
* الدالة <code>[[PHP/Function/range|range()]]</code> : إنشاء مصفوفة تحتوي على مجال من القيم. | * الدالة <code>[[PHP/Function/range|range()]]</code> : إنشاء مصفوفة تحتوي على مجال من القيم. | ||
مراجعة 03:30، 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()
: إنشاء مصفوفة تحتوي على مجال من القيم.