PHP/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()‎: إضافة عنصر واحد أو أكثر إلى بداية المصفوفة.

مصادر

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