(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ı döndürülmek istenirse bu işlev yerine,
array_keys() işlevi süzme_değeri
bağımsız değişkeni ile kullanılmalıdır.
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;
?>