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
  • false - 默認

如果設置為 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);
?>

運行實例