آن شیفت (array_unshift)
تابع «آن شیفت (array_unshift)» عنصرهای جدید را اول آرایه می گذارد. بنابراین ترتیب جابه جا می شود و مقدارهای تازه جلو می افتند. همچنین تعداد جدید عنصرها را برمی گرداند. این تابع برای صف بندی ساده خیلی بدرد می خورد.
تعریف و کاربرد
array_unshift عنصرهای جدید را به ابتدای آرایه اضافه می کند. سپس آرایه بزرگ تر می شود و اندیس های عددی از صفر می افتند. اما کلیدهای متنی ثابت می مانند.
سینتکس (Syntax)
array_unshift($array, $value1, $value2, $value3);
مثال 1: افزودن یک مقدار
عنصر "blue" را اول آرایه بگذار. سپس آرایه چاپ می شود.
<?php
$a = array("a" => "red", "b" => "green");
array_unshift($a, "blue");
print_r($a);
?>
مثال 2: مقدار بازگشتی
این مثال فقط تعداد عنصرهای جدید را نشان می دهد.
<?php
$a = array("a" => "red", "b" => "green");
$count = array_unshift($a, "blue");
print_r($count);
?>
مثال 3: اندیس های عددی
با کلیدهای عددی، اندیس ها دوباره از صفر شروع می شوند.
<?php
$a = array(0 => "red", 1 => "green");
array_unshift($a, "blue");
print_r($a);
?>
نکته ها
نکته: می توانی یک یا چند مقدار اضافه کنی. همچنین از PHP 7.3 امکان فراخوانی فقط با آرایه هم وجود دارد.
نکته: برای حذف از ابتدا از شیفت (array_shift) کمک بگیر. برای افزودن به انتها از پوش (array_push) استفاده کن. همچنین برای تمرین می توانی روی آن شیفت (array_unshift) بیشتر کار کنی.
گام های عملی
- آرایه اولیه را بساز.
- مقدارهای جدید را مشخص کن.
- تابع array_unshift را اجرا کن.
- خروجی یا تعداد عنصرها را بررسی کن.
جمع بندی سریع
- افزودن در ابتدای آرایه انجام می شود.
- اندیس های عددی از صفر می افتند.
- کلیدهای متنی تغییر نمی کنند.
- مقدار بازگشتی، تعداد جدید عنصرهاست.