PHP array_search() 函數

PHP Array Reference完整的 PHP Array 參考手冊

實例

在數組中搜索鍵值 "red"，並返回它的鍵名：

<?php
$a=array("a"=>"red","b"=>"green","c"=>"blue");
echo array_search("red",$a);
?>

定義和用法

array_search() 函數在數組中搜索某個鍵值，並返回對應的鍵名。

語法

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);
?>


PHP Array Reference完整的 PHP Array 參考手冊