ฟังก์ชั่น PHP array_splice()

ตัวอย่าง

ลบองค์ประกอบออกจากอาร์เรย์และแทนที่ด้วยองค์ประกอบใหม่:

<?php$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");$a2=array( "a"=>"สีม่วง","b"=>"สีส้ม");array_splice($a1,0,2,$a2);print_r($a1);?>

ความหมายและการใช้งาน

ฟังก์ชัน array_splice() จะลบองค์ประกอบที่เลือกออกจากอาร์เรย์และแทนที่ด้วยองค์ประกอบใหม่ ฟังก์ชันนี้จะส่งคืนอาร์เรย์ขององค์ประกอบที่ถูกลบออกด้วย

เคล็ดลับ: หากฟังก์ชันไม่ลบองค์ประกอบใดๆ (length=0) อาร์เรย์ทดแทนจะถูกแทรกจากตำแหน่งของพารามิเตอร์เริ่มต้น (ดูตัวอย่างที่ 2)

หมายเหตุ: ชื่อคีย์ในอาร์เรย์ทดแทนจะไม่ถูกรักษาไว้

ไวยากรณ์

 array_splice ( อาร์เรย์, เริ่มต้น, ความยาว, อาร์เรย์ )

พารามิเตอร์	อธิบาย
อาร์เรย์	ที่จำเป็น. ระบุอาร์เรย์
เริ่ม	ที่จำเป็น. ค่าตัวเลข ระบุตำแหน่งเริ่มต้นขององค์ประกอบที่ถูกลบ 0 = องค์ประกอบแรก หากตั้งค่าเป็นจำนวนบวก การลบจะเริ่มต้นที่ออฟเซ็ตในอาร์เรย์ที่ระบุโดยค่า หากตั้งค่าเป็นจำนวนลบ การลบจะเริ่มต้นที่ออฟเซ็ตที่ระบุโดยค่าจากจุดสิ้นสุดของอาร์เรย์ -2 หมายถึง เริ่มจากองค์ประกอบที่สองถึงสุดท้ายของอาร์เรย์
ความยาว	ไม่จำเป็น. ค่าตัวเลข ระบุจำนวนองค์ประกอบที่จะลบออก ซึ่งเป็นความยาวของอาร์เรย์ที่ส่งคืนด้วย หากตั้งค่าเป็นจำนวนบวก จำนวนองค์ประกอบนั้นจะถูกลบออก หากตั้งค่านี้เป็นจำนวนลบ องค์ประกอบทั้งหมดตั้งแต่เริ่มต้นจนถึงความยาวส่วนกลับของจุดสิ้นสุดของอาร์เรย์จะถูกลบออก หากไม่ได้ตั้งค่านี้ องค์ประกอบทั้งหมดจากตำแหน่งที่กำหนดโดยพารามิเตอร์เริ่มต้นจนถึงจุดสิ้นสุดของอาร์เรย์จะถูกลบออก
อาร์เรย์	ไม่จำเป็น. ระบุอาร์เรย์ที่มีองค์ประกอบที่จะแทรกลงในอาร์เรย์ดั้งเดิม หากมีองค์ประกอบเดียวก็สามารถตั้งค่าเป็นสตริงและไม่จำเป็นต้องตั้งค่าเป็นอาร์เรย์

รายละเอียดทางเทคนิค

ค่าส่งคืน:	ส่งกลับอาร์เรย์ที่มีองค์ประกอบที่แยกออกมา
เวอร์ชัน PHP:	4+

ตัวอย่างเพิ่มเติม

ตัวอย่างที่ 1

เช่นเดียวกับตัวอย่างก่อนหน้าในหน้านี้ แต่ส่งออกอาร์เรย์ที่ส่งคืน:

<?php$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");$a2=array( "a"=>"สีม่วง","b"=>"สีส้ม");print_r(array_splice($a1,0,2,$a2));?>

ตัวอย่างที่ 2

โดยตั้งค่าพารามิเตอร์ความยาวเป็น 0:

<?php$a1=array("0"=>"red","1"=>"green");$a2=array("0"=>"สีม่วง","1"=>"สีส้ม") ;array_splice($a1,1,0,$a2);print_r($a1);?>