array_search 在数组中搜索给定的值，如果成功则返回首个相应的键名
发表日期：2021-07-01 08:57:07 | 来源： | | 浏览(629) 分类：数组 函数
array_search
(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
array_search — 在数组中搜索给定的值，如果成功则返回首个相应的键名
说明
$needle, array $haystack, bool $strict = false): mixed
大海捞针，在大海（haystack）中搜索针（
needle 参数）。
参数
-
needle -
搜索的值。
注意:
如果
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.
|
范例
示例 #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() - 检查数组中是否存在某个值
- PHP（0）
- PHP杂项（34）
- PHP基础-李炎恢系列课程（20）
- 中文函数手册（0）
- 错误处理 函数（13）
- OPcache 函数（6）
- PHP 选项/信息 函数（54）
- Zip 函数（10）
- Hash 函数（15）
- OpenSSL 函数（63）
- Date/Time 函数（51）
- 目录函数（9）
- Fileinfo 函数（6）
- iconv 函数（11）
- 文件系统函数（81）
- 多字节字符串 函数（57）
- GD 和图像处理 函数（114）
- 可交换图像信息（5）
- Math 函数（50）
- 程序执行函数（11）
- PCNTL 函数（23）
- JSON 函数（4）
- SPL 函数（15）
- URL 函数（10）
- cURL 函数（32）
- 网络 函数（33）
- FTP 函数（36）
- Session 函数（23）
- PCRE 函数（11）
- PCRE 正则语法（19）
- 数组 函数（81）
- array_change_key_case 将数组中的所有键名修改为全大写或小写（0）
- array_chunk 将一个数组分割成多个（0）
- array_column 返回数组中指定的一列（0）
- array_combine 创建一个数组，用一个数组的值作为其键名，另一个数组的值作为其值（0）
- array_count_values 统计数组中所有的值（0）
- array_diff_assoc 带索引检查计算数组的差集（0）
- array_diff_key 使用键名比较计算数组的差集（0）
- array_diff_uassoc 用用户提供的回调函数做索引检查来计算数组的差集（0）
- array_diff_ukey 用回调函数对键名比较计算数组的差集（0）
- array_diff 计算数组的差集（0）
- array_fill_keys 使用指定的键和值填充数组（0）
- array_fill 用给定的值填充数组（0）
- array_filter 使用回调函数过滤数组的元素（0）
- array_flip 交换数组中的键和值（0）
- array_intersect_assoc 带索引检查计算数组的交集（0）
- array_intersect_key 使用键名比较计算数组的交集（0）
- array_intersect_uassoc 带索引检查计算数组的交集，用回调函数比较索引（0）
- array_intersect_ukey 在键名上使用回调函数来比较计算数组的交集（0）
- array_intersect 计算数组的交集（0）
- array_key_exists 检查数组里是否有指定的键名或索引（0）
- array_key_first 获取指定数组的第一个键值（0）
- array_key_last 获取一个数组的最后一个键值（0）
- array_keys 返回数组中部分的或所有的键名（0）
- array_map 为数组的每个元素应用回调函数（0）
- array_merge_recursive 递归地合并一个或多个数组（0）
- array_merge 合并一个或多个数组（0）
- array_multisort 对多个数组或多维数组进行排序（0）
- array_pad 以指定长度将一个值填充进数组（0）
- array_pop 弹出数组最后一个单元（出栈）（0）
- array_product 计算数组中所有值的乘积（0）
- array_push 将一个或多个单元压入数组的末尾（入栈）（0）
- array_rand 从数组中随机取出一个或多个随机键（0）
- array_reduce 用回调函数迭代地将数组简化为单一的值（0）
- array_replace_recursive 使用传递的数组递归替换第一个数组的元素（0）
- array_replace 使用传递的数组替换第一个数组的元素（0）
- array_reverse 返回单元顺序相反的数组（0）
- array_search 在数组中搜索给定的值，如果成功则返回首个相应的键名（0）
- array_shift 将数组开头的单元移出数组（0）
- array_slice 从数组中取出一段（0）
- array_splice 去掉数组中的某一部分并用其它值取代（0）
- array_sum 对数组中所有值求和（0）
- array_udiff_assoc 带索引检查计算数组的差集，用回调函数比较数据（0）
- array_udiff_uassoc 带索引检查计算数组的差集，用回调函数比较数据和索引（0）
- array_udiff 用回调函数比较数据来计算数组的差集（0）
- array_uintersect_assoc 带索引检查计算数组的交集，用回调函数比较数据（0）
- array_uintersect_uassoc 带索引检查计算数组的交集，用单独的回调函数比较数据和索引（0）
- array_uintersect 计算数组的交集，用回调函数比较数据（0）
- array_unique 移除数组中重复的值（0）
- array_unshift 在数组开头插入一个或多个单元（0）
- array_values 返回数组中所有的值（0）
- array_walk_recursive 对数组中的每个成员递归地应用用户函数（0）
- array_walk 使用用户自定义函数对数组中的每个元素做回调处理（0）
- array 新建一个数组（0）
- arsort 对数组进行降向排序并保持索引关系（0）
- asort 对数组进行升序排序并保持索引关系（0）
- compact 建立一个数组，包括变量名和它们的值（0）
- count 计算数组中的单元数目，或对象中的属性个数（0）
- current 返回数组中的当前值（0）
- each 返回数组中当前的键／值对并将数组指针向前移动一步（0）
- end 将数组的内部指针指向最后一个单元（0）
- extract 从数组中将变量导入到当前的符号表（0）
- in_array 检查数组中是否存在某个值（0）
- key_exists 别名 array_key_exists()（0）
- key 从关联数组中取得键名（0）
- krsort 对数组按照键名逆向排序（0）
- ksort 对数组根据键名升序排序（0）
- list 把数组中的值赋给一组变量（0）
- natcasesort 用“自然排序”算法对数组进行不区分大小写字母的排序（0）
- natsort 用“自然排序”算法对数组排序（0）
- next 将数组中的内部指针向前移动一位（0）
- pos current() 的别名（0）
- prev 将数组的内部指针倒回一位（0）
- range 根据范围创建数组，包含指定的元素（0）
- reset 将数组的内部指针指向第一个单元（0）
- rsort 对数组降序排序（0）
- shuffle 打乱数组（0）
- sizeof count() 的别名（0）
- sort 对数组升序排序（0）
- uasort 使用用户自定义的比较函数对数组中的值进行排序并保持索引关联（0）
- uksort 使用用户自定义的比较函数对数组中的键名进行排序（0）
- usort 使用用户自定义的比较函数对数组中的值进行排序（0）
- 类/对象 函数（18）
- 函数处理 函数（13）
- 变量处理 函数（37）
- SimpleXML 函数（3）
- 杂项 函数（31）
- 字符串 函数（101）
宁公网安备 64010402001209号