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)部指針指向第一個單元