(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
array_search — Bir dizide belirtilen değeri arar ve bulursa ilgili ilk anahtarı döndürür
samanlık'ta iğne arar.
iğneAranacak değer.
Bilginize:
iğnebir dizge ise karşılaştırma harf büyüklüğüne duyarlıdır.
samanlıkDeğerin aranacağı dizi.
türüne_bak Üçüncü türüne_bak bağımsız değişkenine true belirtilmişse array_search() işlevi samanlıkta iğne ile özdeş öğeleri arayacaktır. Bu, samanlıktaki iğne ile sıkı bir tür karşılaştırması yapılacağı ve nesnelerin aynı örneğin üyeleri olması gerektiği anlamına gelir.
Bulursa ilk iğne'nin anahtarını 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 bağımsız değişkeni ile kullanın.
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 Mantıksal Değerler bölümünde bulunabilir. Bu işlevden dönen değeri sınamak için === işleci kullanılabilir.
Ö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;
?>