الفرق بين المراجعتين ل"PHP/array pad"

من موسوعة حسوب
< PHP
اذهب إلى التنقل اذهب إلى البحث
ط (نقل عبد اللطيف ايمش صفحة PHP/Function/array-pad إلى PHP/array pad: إعادة هيكلة التوثيق)
 
(3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 37: سطر 37:
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* الدالة <code>[[PHP/Function/array-fill|array_fill()]]</code>‎ : ملء مصفوفة بالقيم.
+
* الدالة <code>[[PHP/array_fill|array_fill()]]</code>‎ : ملء مصفوفة بالقيم.
* الدالة <code>[[PHP/Function/range|range()]]</code>‎ : إنشاء مصفوفة تحتوي على مجال من القيم.
+
* الدالة <code>[[PHP/range|range()]]</code>‎ : إنشاء مصفوفة تحتوي على مجال من القيم.
  
 
== مصادر ==
 
== مصادر ==

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

مصادر