PHP

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 →