array_search

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

array_search 在數(shù)組中搜索給定的值,如果成功則返回首個相應(yīng)的鍵名

說明

array_search(mixed $needle, array $haystack, bool $strict = false): int|string|false

haystack 中搜索 needle

參數(shù)

needle

搜索的值。

注意:

如果 needle 是字符串,則比較以區(qū)分大小寫的方式進行。

haystack

這個數(shù)組。

strict

如果可選的第三個參數(shù) stricttrue,則 array_search() 將在 haystack 中檢查完全相同的元素。 這意味著同樣嚴格比較 haystackneedle類型,并且對象需是同一個實例。

返回值

如果找到了 needle 則返回它的鍵,否則返回 false。

如果 needlehaystack 中出現(xiàn)不止一次,則返回第一個匹配的鍵。要返回所有匹配值的鍵,應(yīng)該用 array_keys() 加上可選參數(shù) search_value 來代替。

警告

此函數(shù)可能返回布爾值 false,但也可能返回等同于 false 的非布爾值。請閱讀 布爾類型章節(jié)以獲取更多信息。應(yīng)使用 === 運算符來測試此函數(shù)的返回值。

范例

示例 #1 array_search() 例子

<?php
$array 
= array(=> 'blue'=> 'red'=> 'green'=> 'red');

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

參見