定義和用法
array_search() 函數與 in_array() 一樣,在數組中查找一個鍵值。如果找到了該值,匹配元素的鍵名會被返回。如果沒找到,則返回 false。
在 PHP 4.2.0 之前,函數在失敗時返回 null 而不是 false。
如果第三個參數 strict 被指定為 true,則只有在數據類型和值都一致時才返回相應元素的鍵名。
語法
array_search(value,array,strict)
參數 |
描述 |
value
必需。規定在數組中搜索的值。
array
必需。被搜索的數組。
strict
可選。可能的值:
如果值設置為 true,還將在數組中檢查給定值的類型。(參見例子 2)
Example #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;
?>
Warning
本函數可能返回布爾值 FALSE,但也可能返回一個與 FALSE 等值的非布爾值,例如 0 或者 ""。請參閱布爾類型章節以獲取更多信息。應使用 === 運算符來測試本函數的返回值。
例子 1
復制代碼 代碼如下:
<?php
$a=array("a"=>"Dog","b"=>"Cat","c"=>"Horse");
echo array_search("Dog",$a);
?>
輸出:a
例子 2
復制代碼 代碼如下:
<?php
$a=array("a"=>"5","b"=>5,"c"=>"5");
echo array_search(5,$a,true);
?>
輸出:
b