array_search
(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
array_search — 在陣列中搜索給定的值，如果成功則返回首個相應的鍵名
說明
在 haystack 中搜索 needle。
參數
-
needle -
搜索的值。
注意:
如果
needle是字串，則比較以區分大小寫的方式進行。 -
haystack -
這個陣列。
-
strict -
如果可選的第三個參數
strict為true，則 array_search() 將在haystack中檢查完全相同的元素。 這意味著同樣嚴格比較haystack里needle的 型別，並且對像需是同一個實例。
返回值
如果找到了 needle 則返回它的鍵，否則返回 false。
如果 needle 在
haystack
中出現不止一次，則返回第一個匹配的鍵。要返回所有匹配值的鍵，應該用
array_keys() 加上可選參數
search_value 來代替。
範例
示例 #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;
?>
參見
- array_keys() - 返回陣列中部分的或所有的鍵名
- array_values() - 返回陣列中所有的值
- array_key_exists() - 檢查陣列里是否有指定的鍵名或索引
- in_array() - 檢查陣列中是否存在某個值