[函数]key()函数—用法及示例

函数名称：key()

函数描述：key() 函数返回数组中当前指针位置的键名。

适用版本：PHP 4, PHP 5, PHP 7

语法：key(array $array): mixed

参数：

• $array：必需，输入的数组。

返回值：返回当前指针位置的键名。如果指针超出数组范围，则返回 NULL。

示例：

$array = array('a' => 'apple', 'b' => 'banana', 'c' => 'cherry');

// 将指针指向数组的第一个元素
reset($array);

// 返回当前指针位置的键名
echo key($array); // 输出: a

// 将指针向后移动一个位置
next($array);

// 返回当前指针位置的键名
echo key($array); // 输出: b

// 将指针向后移动一个位置
next($array);

// 返回当前指针位置的键名
echo key($array); // 输出: c

// 将指针向后移动一个位置，此时指针超出数组范围，返回 NULL
next($array);

// 返回当前指针位置的键名，输出 NULL
echo key($array);

以上示例中，我们创建了一个关联数组 $array，然后使用 reset() 函数将指针指向数组的第一个元素。接着，我们使用 key() 函数分别获取了当前指针位置的键名。通过 next() 函数，我们将指针向后移动一个位置，并再次调用 key() 函数获取当前指针位置的键名。当指针超出数组范围时，key() 函数返回 NULL。

请注意，key() 函数只返回当前指针位置的键名，并不会改变指针位置。如果需要改变指针位置，可以使用 next()、prev()、end()、reset() 等函数。