(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
array_search — 在數(shù)組中搜索給定的值,如果成功則返回首個相應(yīng)的鍵名
在 haystack
中搜索 needle
。
needle
搜索的值。
注意:
如果
needle
是字符串,則比較以區(qū)分大小寫的方式進(jìn)行。
haystack
這個數(shù)組。
strict
如果可選的第三個參數(shù) strict
為 true
,則
array_search() 將在 haystack
中檢查完全相同的元素。
這意味著同樣嚴(yán)格比較 haystack
里 needle
的 類型,并且對象需是同一個實(shí)例。
如果找到了 needle
則返回它的鍵,否則返回 false
。
如果 needle
在
haystack
中出現(xiàn)不止一次,則返回第一個匹配的鍵。要返回所有匹配值的鍵,應(yīng)該用
array_keys() 加上可選參數(shù)
search_value
來代替。
此函數(shù)可能返回布爾值
false
,但也可能返回等同于 false
的非布爾值。請閱讀 布爾類型章節(jié)以獲取更多信息。應(yīng)使用
===
運(yùn)算符來測試此函數(shù)的返回值。
示例 #1 array_search() 例子
<?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;
?>