key

(PHP 4, PHP 5, PHP 7, PHP 8)

key从关联数组中取得键名

说明

key(array|object $array): int|string|null

key() 返回数组中当前单元的键名。

参数

array

该数组。

返回值

key() 函数返回数组中内部指针指向的当前单元的键名。 但它不会移动指针。如果内部指针超过了元素列表尾部,或者数组是空的,key() 会返回 null

更新日志

版本 说明
8.1.0 弃用在 object 上调用此函数。 在 object 优先使用 get_mangled_object_vars() 或者使用 ArrayIterator

范例

示例 #1 key() 例子

<?php
$array 
= array(
    
'fruit1' => 'apple',
    
'fruit2' => 'orange',
    
'fruit3' => 'grape',
    
'fruit4' => 'apple',
    
'fruit5' => 'apple');

// 此循环将会输出数组中所有值等于 “apple” 的键(key)
while ($fruit_name current($array)) {
    if (
$fruit_name == 'apple') {
        echo 
key($array), "\n";
    }
    
next($array);
}
?>

以上例程会输出:

fruit1
fruit4
fruit5

参见