PHP array_search() 函數
實例
在數組中搜索鍵值 "red",并返回它的鍵名:
<?php $a=array("a"=>"red","b"=>"green","c"=>"blue"); echo array_search("red",$a); ?>
定義和用法
array_search() 函數在數組中搜索某個鍵值,并返回對應的鍵名。
詳細說明
array_search() 函數與 in_array() 一樣,在數組中查找一個鍵值。如果找到了該值,匹配元素的鍵名會被返回。如果沒找到,則返回 false。
在 PHP 4.2.0 之前,函數在失敗時返回 null 而不是 false。
如果第三個參數 strict 被指定為 true,則只有在數據類型和值都一致時才返回相應元素的鍵名。
語法
array_search(value,array,strict)
參數 | 描述 |
---|---|
value | 必需。規定需要搜素的鍵值。 |
array | 必需。規定被搜索的數組。 |
strict |
可選。如果該參數被設置為 TRUE,則函數在數組中搜索數據類型和值都一致的元素。可能的值:
如果設置為 true,則在數組中檢查給定值的類型,數字 5 和字符串 5 是不同的(參見實例 2)。 |
技術細節
返回值: |
如果在數組中找到指定的鍵值,則返回對應的鍵名,否則返回 FALSE。 如果在數組中找到鍵值超過一次,則返回第一次找到的鍵值所匹配的鍵名。 |
PHP 版本: | 4.0.5+ |
更新日志: |
如果向函數傳遞無效的參數,函數返回 NULL(這個適用于自 PHP 5.3.0 起的所有的 PHP 函數)。 自 PHP 4.2.0 起,如果搜索失敗,該函數返回 FALSE,而不是 NULL。 |
更多實例
例子 1
在數組中搜索鍵值 5,并返回它的鍵名(注意 ""):
<?php $a=array("a"=>"5","b"=>5,"c"=>"5"); echo array_search(5,$a,true); ?>