فنکشن array_push() PHP

مثال

به انتهای آرایه "blue" و "yellow" اضافه کنید:

<?php
$a=array("red","green");
array_push($a,"blue","yellow");
print_r($a);
?>

مثال اجرایی

تعریف و استفاده

فنکشن array_push() یک یا چند عنصر به انتهای آرایه اولین پارامتر اضافه می‌کند (تقریباً به صورت stack) و طول جدید آرایه را بازمی‌گرداند.

این فنکشن معادل چندین بار فراخوانی $array[] = $value است.

نکات و توجهات

نکات و توجهاتحتی اگر آرایه شامل کلیدهای استرینگ باشد، عناصر اضافه شده همیشه کلیدهای عددی خواهند بود. (مطابق مثال 2)

نکات و توجهاتاگر می‌خواهید یک واحد به آرایه اضافه کنید، به جای استفاده از array_push()، از $array[] = استفاده کنید، زیرا این کار بار اضافی فراخوانی یک فنکشن را ندارد.

نکات و توجهاتاگر اولین پارامتر یک آرایه نباشد، array_push() یک هشدار صادر خواهد کرد. این با رفتار $var[] متفاوت است، که یک آرایه جدید ایجاد می‌کند.

نحوه استفاده

array_push(آرایه,value1,value2...)
پارامتر توضیح
آرایه ضروری. آرایه را مشخص کنید.
value1 ضروری. مقدار مورد نظر را مشخص کنید.
value2 اختیاری. مقدار مورد نظر را مشخص کنید.

جزئیات فنی

مقدار بازگشتی: تعداد عناصر جدید آرایه را بازمی‌گرداند.
نسخه PHP: 4+

مثال‌های بیشتر

مثال 1

آرایه با کلید‌های استرینگ:

<?php
$a=array("a"=>"red","b"=>"green");
array_push($a,"blue","yellow");
print_r($a);
?>

مثال اجرایی