Documentación offline PHP master

array_key_first

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

array_key_first

Recupera la primera clave de un array

Descripción#

array_key_first(array $array): int
```php

Recupera la primera clave del array `array` dado sin afectar el puntero interno del array.

## Parámetros

`array`  
Un array.

## Valores devueltos

Devuelve la primera clave de `array` si el array no está vacío; `null` en caso contrario.

## Ejemplos

Uso simple de `array_key_first`
1, 'b' => 2, 'c' => 3]; $firstKey = array_key_first($array); var_dump($firstKey); ?>

```php

El ejemplo anterior mostrará:

string(1) "a"

Notas#

[!TIP] Hay varias maneras de proporcionar esta funcionalidad para versiones anteriores a PHP 7.3.0. Es posible utilizar array_keys, pero esto es bastante ineficiente. También es posible utilizar reset y key, pero esto puede cambiar el puntero interno del array. Una solución eficiente, que no modifica el puntero interno del array, escrita como un polyfill:

``` $unused) { return $key; } return NULL; } } ?>

```

Véase también#

array_first

array_key_last

reset