PHP Conference Japan 2024

    array_key_first

    (PHP 7 >= 7.3.0, PHP 8)

    array_key_first — 获取数组的第一个键

    描述

    array_key_first(数组 $array): 整数|字符串|空

    获取给定 array 的第一个键，而不影响内部数组指针。

    参数

    数组

    一个数组。

    返回值

    如果数组不为空，则返回 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 之前的版本中，有多种方法可以提供此功能。可以使用 array_keys()，但这可能效率低下。也可以使用 reset() 和 key()，但这可能会更改内部数组指针。一个有效的解决方案，它不会更改内部数组指针，编写为填充程序

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

    参见

    发现问题？

    了解如何改进此页面 • 提交拉取请求 • 报告错误
    ＋添加注释

    用户贡献的注释 1 条注释

    顶
    踩
    2
    MaxiCom dot Developpement at gmail dot com
    11 个月前
    填充程序的作用是追溯地将 PHP 版本的新功能合并到旧的 PHP 版本中，以确保 API 兼容性。

    在 PHP 7.3.0 中，引入了 array_key_first() 函数，以下示例中演示了该函数

    <?php

    $array     = [
    'first_key' => 'first_value',
    'second_key' => 'second_value',
    ];

    var_dump(array_key_first($array));

    ?>

    此文档中提供的填充程序允许在 PHP 7.3.0 之前的 PHP 版本中方便地使用 array_key_first() 并保持 API 兼容性，在这些版本中尚未实现该函数

    <?php

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

    $array = [
    'first_key' => 'first_value',
    'second_key' => 'second_value',
    ];

    var_dump(array_key_first($array));

    ?>
    ＋添加注释
    To Top