فنکشن array_unshift() PHP

مثال

عنصر "blue" را به آرایه اضافه کنید:

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

اجرای نمونه

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

فنکشن array_unshift() برای اضافه کردن عناصر جدید به آرایه استفاده می‌شود. مقادیر جدید آرایه به ابتدای آرایه اضافه می‌شوند.

عناصر اضافه شده به عنوان یک کل به آرایه اضافه می‌شوند و ترتیب آن‌ها در آرایه با ترتیب در پارامترها یکسان است.

این فنکشن بازده تعداد عناصر موجود در آرایه را برمی‌گرداند.

توجه:می‌توانید یک یا چند مقدار را اضافه کنید.

نکته:کلیدهای عددی از 0 شروع شده و به ترتیب 1 افزایش می‌یابند. کلیدهای رشته‌ای بدون تغییر باقی می‌مانند.

نوع

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

جزئیات فنی

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

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

مثال 1

نمایش بازده:

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

اجرای نمونه

مثال 2

استفاده از کلیدهای عددی:

<?php
$a=array(0=>"red",1=>"green");
array_unshift($a,"blue");
print_r($a);
?>

اجرای نمونه