PHP/array pad

(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()‎ : إنشاء مصفوفة تحتوي على مجال من القيم.

مصادر

• صفحة الدالة array_pad‎ في توثيق PHP الرسمي.