ฟังก์ชัน array_unshift() ใช้เพิ่มสมาชิกหนึ่งหรือหลายตัวไปที่ จุดเริ่มต้น (ต้นทาง) ของอาร์เรย์ คีย์ตัวเลขจะถูกกำหนดใหม่ (re-index) เริ่มจาก 0 ส่วนคีย์สตริงจะคงเดิม
ไวยากรณ์ (Syntax)
array_unshift(array, value1, value2, value3, ...)
พารามิเตอร์ (Parameters)
array − อาร์เรย์ที่ต้องการเพิ่มสมาชิก (จำเป็น)
value1 − ค่าที่จะเพิ่ม (จำเป็น)
value2, value3, ... − ค่าเพิ่มเติม (ตัวเลือก)
ค่าที่ส่งคืน (Return Value)
ส่งคืน จำนวนสมาชิกใหม่ของอาร์เรย์ หลังจากเพิ่มแล้ว
ตัวอย่างการใช้งาน
ตัวอย่างที่ 1: เพิ่มสมาชิกเดียวและแสดงจำนวนสมาชิกใหม่
<?php
$arr = array("p" => "one", "q" => "two");
print_r(array_unshift($arr, "three"));
?>
ผลลัพธ์
3
ตัวอย่างที่ 2: เพิ่มสมาชิกและแสดงอาร์เรย์ทั้งหมด
<?php
$arr = array("p" => "one", "q" => "two");
array_unshift($arr, "three");
print_r($arr);
?>
ผลลัพธ์
Array ( [0] => three [p] => one [q] => two )