array_key_first

(PHP 7 >= 7.3.0, PHP 8)

array_key_first — 獲取指定數(shù)組的第一個鍵

說明

array_key_first(array $array): int|string|null

不影響到數(shù)組內(nèi)部指針，取得指定數(shù)組的 array 第一個鍵。

參數(shù)

array

要操作的數(shù)組。

返回值

如果 array 不是空的，返回第一個鍵，否則返回 null。

范例

示例 #1 array_key_first() 基本用法

<?php
$array = ['a' => 1, 'b' => 2, 'c' => 3];

$firstKey = array_key_first($array);

var_dump($firstKey);
?>

以上例程會輸出：

string(1) "a"

注釋

小技巧

在 PHP 7.3.0 之前，有幾種方式可以實現(xiàn)該功能。可以使用 array_keys() 函數(shù)，但是性能會比較低。也可以使用 reset() 和 key() 函數(shù)，但這可能會影響內(nèi)部數(shù)組指針。實現(xiàn)該功能的 polyfill 寫法如下:

<?php
if (!function_exists('array_key_first')) {
    function array_key_first(array $arr) {
        foreach($arr as $key => $unused) {
            return $key;
        }
        return NULL;
    }
}
?>

參見

  • array_key_last() - 獲取一個數(shù)組的最后一個鍵值
  • reset() - 將數(shù)組的內(nèi)部指針指向第一個單元