(PHP 4 >= 4.0.5, PHP 5)
array_search — 在数组中搜索给定的值,如果成功则返回相应的键名
说明
mixed array_search ( mixed$needle
, array $haystack
[, bool $strict
= false
] )
在 haystack
中搜索
needle
参数。
参数
needle
搜索的值。
Note:
如果 needle
是字符串,则比较以区分大小写的方式进行。
haystack
这个数组。
strict
如果可选的第三个参数 strict
为 TRUE
,则
array_search() 将在 haystack
中检查完全相同的元素。
这意味着同样检查 haystack
里 needle
的 类型,并且对象需是同一个实例。
返回值
如果找到了 needle
则返回它的键,否则返回 FALSE
。
如果 needle
在
haystack
中出现不止一次,则返回第一个匹配的键。要返回所有匹配值的键,应该用
array_keys() 加上可选参数
search_value
来代替。
此函数可能返回布尔值
FALSE
,但也可能返回等同于 FALSE
的非布尔值。请阅读 布尔类型章节以获取更多信息。应使用
===
运算符来测试此函数的返回值。
更新日志
版本
说明
5.3.0
As with all internal PHP functions as of 5.3.0,
array_search() returns NULL
if invalid parameters
are passed to it.
4.2.0
在 PHP 4.2.0 之前,array_search() 在失败时返回
NULL
而不是 FALSE
。
范例
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;
?>
参见
array_keys() - 返回数组中所有的键名 array_values() - 返回数组中所有的值 array_key_exists() - 检查给定的键名或索引是否存在于数组中 in_array() - 检查数组中是否存在某个值