Bir dizide belirtilen değeri arar ve bulursa ilgili anahtarı döndürür

Açıklama

array_search ( mixed $iğne , array $samanlık [, bool $türüne_bak ] ) : mixed

samanlık'ta iğne arar.

Değiştirgeler

iğne: Aranacak değer.

Bilginize:
iğne bir dizge ise karşılaştırma harf büyüklüğüne duyarlıdır.
samanlık: Değerin aranacağı dizi.
türüne_bak: Bu değiştirgede TRUE belirtilmişse array_search() işlevi ayrıca, iğne'yi samanlık'ta ararken türüne de bakar.

Dönen Değerler

Bulursa iğne'yi bulamazsa FALSE döndürür.

Eğer iğne, samanlık içinde birden fazla varsa ilk bulunan döndürülür. Eşleşen tüm değerlerin anahtarlarını döndürmek isterseniz bu işlevi kullanmak yerine, array_keys() işlevini seçimlik arama_değeri değiştirgesi ile kullanın.

Uyarı

Bu işlev mantıksal FALSE değeriyle dönebileceği gibi FALSE olarak değerlendirilebilecek mantıksal olmayan bir değerle de dönebilir. Bu konuda daha fazla bilgi edinmek için Mantıksal Değerler bölümüne bakabilirsiniz. Bu işlevden dönen değeri sınamak için === işlecini kullanınız.

Sürüm Bilgisi

Sürüm:	Açıklama
4.2.0	PHP 4.2.0 öncesinde, array_search() aranan değeri bulamazsa `FALSE` yerine `NULL` döndürürdü.

Örnekler

Örnek 1 - array_search() örneği


<?php
$array = array(0 => 'blue', 1 => 'red', 2 => 'green', 3 => 'red');

$key = array_search('green', $array); // $key = 2;
$key = array_search('red', $array);   // $key = 1;
?>

Ayrıca Bakınız

array_keys() - Bir dizideki tüm anahtarları veya bir anahtar altkümesini döndürür
array_values() - Bir dizinin tüm değerlerini döndürür
array_key_exists() - Belirtilen anahtar veya indis dizide var mı diye bakar
in_array() - Bir dizide bir değerin varlığını araştırır