
تابع array_push در PHP
در این بخش به بررسی تابع array_push در PHP می پردازیم، تابع array_push()
یک یا چند عنصر را در انتهای یک آرایه وارد می کند.
مثال
در این مثال دو مقدار “blue” و “yellow” را در انتهای یک آرایه اضافه می کنیم:
خروجی کد های بالا به این شکل است:
Array ( [0] => red [1] => green [2] => blue [3] => yellow )
نکته: شما می توانید هرچندتا مقداری را که می خواهید به آخر آرایه اضافه کنید.
توجه: حتی اگر آرایه شما دارای کلید های رشته ای باشد، عناصر جدید اضافه شده به آرایه کلید های عددی خواهند داشت.
نحوه استفاده
array_push(array, value1, value2, ...)
مقادیر پارامترها
پارامتر | توضیحات |
---|---|
array | یک آرایه را مشخص می کند. (اجباری) |
value1 | یک مقدار برای اضافه شدن به آرایه را مشخص می کند (اختیاری)، در نسخه های قبل از PHP 7.3 این پارامتر اجباری است. |
value2… | یک مقدار برای اضافه شدن به آرایه را مشخص می کند. (اختیاری) |
جزئیات فنی
مقدار بازگشتی: | پس از اضافه شدن عناصر جدید، تعداد عناصر موجود آرایه را برمی گرداند. |
---|---|
نسخه PHP: | 4+ |
آخرین تغییرات: | از PHP 7.3 این تابع فقط می تواند با پارامتر array فراخوانی بشود. |
مثال های بیشتر
در این مثال دو مقدار را به یک آرایه با کلید های رشته ای اضافه می کنیم:
خروجی کد های بالا به این شکل است:
Array ( [a] => red [b] => green [0] => blue [1] => yellow )
(در زمان حكومت عمر، نسبت به فراوانى زيور و زينت هاى كعبه صحبت شد، گروهى گفتند آنها را براى لشكر اسلام مصرف كن، كعبه زر و زينت نمى خواهد، وقتى از امير المؤمنين عليه السّلام پرسيدند، فرمود):
ضرورت حفظ اموال كعبه
همانا قرآن بر پيامبر صلّى اللّه عليه و آله و سلّم هنگامى نازل گرديد كه اموال چهار قسم بود، اموال مسلمانان، كه آن را بر أساس سهم هر يك از وارثان، تقسيم كرد، و غنيمت جنگى كه آن را به نيازمندانش رساند، و خمس، كه خدا جايگاه مصرف آن را تعيين فرمود، و صدقات، كه خداوند راه هاى بخشش آن را مشخّص فرمود.
و زيور آلات و زينت كعبه از اموالى بودند كه خدا آن را به حال خود گذاشت، نه از روى فراموشى آن را ترك كرد، و نه از چشم خدا پنهان بود، تو نيز آن را به حال خود واگذار چنانكه خدا و پيامبرش آن را بحال خود واگذاشتند.
عمر گفت: اگر تو نبودى رسوا مى شديم، و متعرّض زيور آلات كعبه نشد.
حکمت 270 نهج البلاغه