فنکشن 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); ?>