Latest web development tutorials

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參考手冊