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);
?>

Contoh Berjalan

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:

  • true
  • false - Default

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);
?>

Contoh Berjalan