array_search
array_search
(PHP 4 >= 4.0.5, PHP 5, PHP 7)
array_search - 在数组中搜索给定值并在成功时返回第一个对应的键
描述
mixed array_search ( mixed $needle , array $haystack [, bool $strict = false ] )
搜索 haystack 里的指针。
参数
needle
搜索的值。
注意
:如果needle
是字符串,则比较以区分大小写的方式完成。
haystack
数组。
strict
如果第三个参数strict设置为TRUE,那么array_search()函数将搜索haystack中的相同元素。 这意味着它也将在干草堆中执行针的严格类型比较,并且对象必须是相同的实例。
返回值
如果它在数组中找到,则返回针的键;否则返回FALSE。
如果在 haystack 中发现不止一次针,则返回第一个匹配键。 要返回所有匹配值的键,请改用带可选search_value参数的array_keys()。
警告
该函数可能返回布尔值FALSE
,但也可能返回一个非布尔值,其值为FALSE
。有关更多信息,请阅读布尔部分。使用===运算符来测试此函数的返回值。
更新日志
版 | 描述 |
---|---|
5.3.0 | 与5.3.0中的所有内部PHP函数一样,如果将无效参数传递给array_search(),则返回NULL。 |
例子
示例#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() - 检查数组中是否存在值
← array_reverse
array_shift →