ฟังก์ชัน array_search() ของ PHP
ตัวอย่าง
ค้นหาค่าหลัก "red" ในแบบจำกัด และคืนค่าชื่อตัวแปรที่ตรงกับค่านั้น
<?php $a=array("a"=>"red","b"=>"green","c"=>"blue"); echo array_search("red",$a); ?>
คำอธิบายและวิธีใช้
ฟังก์ชัน array_search() ในแบบจำกัด ค้นหาค่าหลักบางอย่าง และคืนค่าชื่อตัวแปรที่ตรงกับค่านั้น
รายละเอียด
ฟังก์ชัน array_search() กับ in_array() คล้ายกัน การหาค่าหลักในแบบจำกัด ถ้าหากพบค่านั้น ชื่อตัวแปรที่ตรงกับค่านั้นจะถูกคืนค่ากลับ ถ้าไม่พบ ก็จะคืนค่า false
ก่อน PHP 4.2.0 ฟังก์ชันจะกลับค่า null แทนที่จะ false
ถ้ามีค่าที่ระบุเป็น strict ถ้าตั้งค่าเป็น true จะกลับค่าชื่อหลักขององค์ประกอบที่มีชนิดของค่าและค่าที่เหมือนกัน
รูปแบบ
array_search(value,array,strict)
ตัวแปร | คำอธิบาย |
---|---|
value | จำเป็น |
array | จำเป็น |
strict |
ตัวเลือก
ถ้าตั้งค่าเป็น true จะตรวจสอบชนิดของค่าที่ให้ ตัวเลข 5 และตัวแปร 5 คือเท่ากัน (ดูตัวอย่าง 2) |
รายละเอียดเทคนิค
ค่าที่กลับค่า |
ถ้าหาค่าหลักที่ระบุไว้ในตารางแบบกลุ่ม จะกลับค่าชื่อหลักที่ตรงกับค่าหลักนั้น ถ้าไม่พบจะกลับค่า FALSE ถ้ามีการหาค่าหลักที่มากกว่าครั้งหนึ่งในตารางแบบกลุ่ม จะกลับค่าชื่อหลักที่หาได้ครั้งแรก |
PHP รุ่น | 4.0.5+ |
บันทึกการปรับปรุง |
ถ้าส่งค่าที่ไม่ถูกต้องให้กับฟังก์ชัน ฟังก์ชันจะกลับค่า NULL (นี่เป็นสิ่งที่เป็นไปได้สำหรับทุกฟังก์ชัน PHP ที่เริ่มต้นด้วย PHP 5.3.0) ตั้งแต่ PHP 4.2.0 ถึงตอนนี้ ถ้าการค้นหาล้มเหลว ฟังก์ชันจะกลับค่า FALSE แทนที่จะ NULL |
ตัวอย่างเพิ่มเติม
ตัวอย่าง 1
ค้นหาค่าในตารางแบบกลุ่มซึ่งมีค่าหลัก 5 และกลับค่าชื่อหลัก (ให้เห็น ""):
<?php $a=array("a"=>"5","b"=>5,"c"=>"5"); echo array_search(5,$a,true); ?>