Fungsi array_search() di PHP
Contoh
Mencari nilai kunci "red" di dalam array dan mengembalikan nama kunci yang cocok:
<?php $a=array("a"=>"red","b"=>"green","c"=>"blue"); echo array_search("red",$a); ?>
Definisi dan penggunaan
Fungsi array_search() mencari nilai kunci di dalam array dan mengembalikan nama kunci yang cocok.
Penjelasan detil
Fungsi array_search() dengan in_array() Sama seperti mencari nilai kunci di dalam array. Jika nilai yang dicari ditemukan, nama kunci elemen yang cocok akan dikembalikan. Jika tidak ditemukan, maka akan dikembalikan nilai false.
Sebelum PHP 4.2.0, fungsi mengembalikan null bukannya false saat gagal.
Jika parameter ketiga strict Didefinisikan true, hanya kembalikan nama kunci elemen yang cocok jika tipe data dan nilai sama.
Sintaks
array_search(value,array,strict)
Parameter | Deskripsi |
---|---|
value | Wajib. Tentukan nilai kunci yang akan dicari. |
array | Wajib. Tentukan array yang akan dicari. |
strict |
Pilihan. Jika parameter diatur TRUE, fungsi mencari elemen yang cocok dalam array untuk nilai dan tipe data yang sama. Nilai yang mungkin:
Jika diatur true, memeriksa tipe nilai yang diberikan dalam array, angka 5 dan string 5 adalah berbeda (lihat contoh 2). |
Detil Teknis
Nilai Kembalian: |
Jika ada penemuan nilai kunci yang ditentukan dalam array, kembalikan nama kunci yang cocok, jika tidak, kembalikan FALSE. Jika ada beberapa penemuan nilai kunci yang sama dalam array, kembalikan nama kunci yang cocok untuk penemuan pertama. |
Versi PHP: | 4.0.5+ |
Log Pembaruan: |
Jika parameter yang disampaikan kepada fungsi tidak valid, fungsi mengembalikan NULL (ini berlaku untuk semua fungsi PHP sejak PHP 5.3.0). Dari PHP 4.2.0, jika pencarian gagal, fungsi ini mengembalikan FALSE bukannya NULL. |
Beberapa Contoh Lain
Contoh 1
Cari nilai kunci 5 dalam array, dan kembalikan nama kunci yang cocok (perhatikan ""):
<?php $a=array("a"=>"5","b"=>5,"c"=>"5"); echo array_search(5,$a,true); ?>