array_push()
(PHP 4, PHP 5, PHP 7)
تدفع الدالة array_push() عنصرًا واحدًا أو أكثر إلى نهاية المصفوفة.
الوصف
int array_push ( array &$array , mixed $value1 [, mixed $... ])
تعامل الدالة array_push() المصفوفة array كمكدس (stack)، وتدفع المتغيرات التي مررناها إلى نهاية المصفوفة array وسيزداد طولها بعدد المتغيرات التي أضفناها. ولها نفس تأثير الشيفرة الآتية:
<?php
$array[] = $var;
?>
مع تكرارها لكل قيمة يتم إدخالها.
ملاحظة: إذا كنت تستخدم array_push() لإضافة عنصر واحد إلى المصفوفة، فمن الأفضل استخدام $array[] = لأن هذه الطريقة توفر حِمل استدعاء دالة.
ملاحظة : سوف تصدر array_push() تحذيرًا إذا لم يكن الوسيط الأول مصفوفةً. ويختلف هذا عن سلوك $var[] إذ سيُنشِئ مصفوفةً جديدةً.
المعاملات
array
المصفوفة المُدخلة.
value1
القيمة الأولى المراد إدخالها في نهاية المصفوفة array.
القيم المُعادة
تُعيد الدالة array_push() عدد العناصر الجديدة في المصفوفة.
أمثلة
مثال 1: مثال على الدالة array_push()
<?php
$stack = array("orange", "banana");
array_push($stack, "apple", "raspberry");
print_r($stack);
?>
سوف تكون مُخرجات المثال أعلاه كالتالي:
Array
(
[0] => orange
[1] => banana
[2] => apple
[3] => raspberry
)
انظر أيضًا
array_pop(): إزالة العنصر الأخير في نهاية المصفوفة وإعادة قيمته.array_shift(): إزالة عنصر من بداية المصفوفة وإعادة قيمته.array_unshift(): إضافة عنصر واحد أو أكثر إلى بداية المصفوفة.