array_key_first

Parametry

• $array – tablica wejściowa.

Przykłady

echo array_key_first(array("a" => 1, "b" => 2)); // a
// pierwszy jest element dodany jako pierwszy, a nie ten z najmniejszym kluczem
echo array_key_first(array(5 => "x", 2 => "y")); // 5
// pusta tablica
var_dump(array_key_first(array())); // NULL
// pierwsza wartość tablicy
$array = array("x" => 10, "y" => 20);
echo $array[array_key_first($array)]; // 10
// po usunięciu elementu pierwszy klucz nie jest już 0
$list = array("a", "b", "c");
unset($list[0]);
echo array_key_first($list); // 1
// zamiennik dla PHP przed 7.3
$first = null;
foreach ($array as $key => $value) {
  $first = $key;
  break;
}
echo $first; // x

Na co uważać

• Funkcja istnieje dopiero od PHP 7.3. W starszych wersjach użyj pętli z przykładu albo pary reset() i key().
• Dla pustej tablicy zwraca null. Zanim odczytasz $array[array_key_first($array)], upewnij się więc, że tablica nie jest pusta.
• „Pierwszy” oznacza pierwszy w kolejności, w jakiej elementy są w tablicy. Najmniejszy klucz zwróci min(array_keys($array)).
• Funkcja, która od razu zwraca pierwszą wartość (array_first), istnieje w PHP dopiero od wersji 8.5.

Powiązane funkcje:
array_key_last()
array_keys()
reset()
array_first()