大网数据广告活动
PHP 语言与运行手册

array_find_key · 返回满足回调函数条件的第一个元素的键

· 52CE 我爱测

array_find_key() 返回 array 中第一个使指定 callback 返回 true 的元素的键。如果未找到匹配元素,则该函数返回 null。

array_find_key

(PHP 8 >= 8.4.0)

array_find_key — 返回满足回调函数条件的第一个元素的键

说明

function array_find_key(array $array, callable $callback): mixed

array_find_key() 返回 array 中第一个使指定 callback 返回 true 的元素的键。如果未找到匹配元素,则该函数返回 null。

参数

array

需要被遍历的 array。

callback

用于检查每个元素的回调函数,该函数必须

function callback(mixed $value, mixed $key): bool
如果该函数返回 true,array_find_key() 就会返回对应键名,并且不再对后续元素执行该回调函数。

返回值

该函数会返回首个使 callback 返回 true 的元素的键。如果未找到匹配的元素,则函数返回 null。

示例

示例 #1 array_find_key() 示例

<?php
$array = [
    'a' => 'dog',
    'b' => 'cat',
    'c' => 'cow',
    'd' => 'duck',
    'e' => 'goose',
    'f' => 'elephant'
];

// Find the first animal with a name longer than 4 characters.
var_dump(array_find_key($array, function (string $value) {
    return strlen($value) > 4;
}));

// Find the first animal whose name begins with f.
var_dump(array_find_key($array, function (string $value) {
    return str_starts_with($value, 'f');
}));

// Find the first animal where the array key is the first symbol of the animal.
var_dump(array_find_key($array, function (string $value, $key) {
   return $value[0] === $key;
}));

// Find the first animal where the array key matching a RegEx.
var_dump(array_find_key($array, function ($value, $key) {
   return preg_match('/^([a-f])$/', $key);
}));
?>

以上示例会输出:

string(1) "e"
NULL
string(1) "c"
string(1) "a"

参见

  • array_find() - 返回满足回调函数条件的第一个元素
  • array_all() - 检查数组所有元素是否都满足回调函数的条件
  • array_any() - 检查数组中是否至少有一个元素满足回调函数的条件
  • array_filter() - 使用回调函数过滤数组的元素
  • array_reduce() - 用回调函数迭代地将数组简化为单一的值

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。