array_search

(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

Açıklama

array_search(mixed $iğne, array $samanlık, bool $türüne_bak = false): int|string|false

samanlık'ta iğne arar.

Bağımsız Değişkenler

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: Üçü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.

Dönen Değerler

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.

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 Mantıksal Değerler bölümünde bulunabilir. Bu işlevden dönen değeri sınamak için === işleci kullanılabilir.

Ö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