key

(PHP 4, PHP 5, PHP 7)

keyLiefert einen Schlüssel eines Arrays

Beschreibung

key ( array $array ) : mixed

key() liefert das Index Element der aktuellen Position im Array.

Parameter-Liste

array

Das Array.

Rückgabewerte

Die key() Funktion gibt einfach den Schlüssel des Arrayelements zurück, auf das momentan durch den internen Zeiger gezeigt wird. Sie bewegt den Zeiger in keiner Weise. Zeigt der interne Zeiger über das Ende der Elementliste hinaus oder ist das Array leer, gibt key() NULL zurück.

Changelog

Version Beschreibung
7.0.0 array wird nun immer als Wert übergeben. Vor dieser Version wurde es, wenn möglich, als Referenz übergeben, und andernfalls als Wert.

Beispiele

Beispiel #1 key() Beispiel

<?php
$array 
= array(
    
'Frucht1' => 'Apfel',
    
'Frucht2' => 'Orange',
    
'Frucht3' => 'Traube',
    
'Frucht4' => 'Apfel',
    
'Frucht5' => 'Apfel');

// Diese Schleife gibt alle Schlüssel des assoziativen 
// Arrays aus, deren Wert "Apfel" ist.
while ($fruit_name current($array)) {
    if (
$fruit_name == 'Apfel') {
        echo 
key($array).'<br />';
    }
    
next($array);
}
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Frucht1<br />
Frucht4<br />
Frucht5<br />

Siehe auch

  • current() - Liefert das aktuelle Element eines Arrays
  • next() - Rückt den internen Zeiger eines Arrays vor
  • foreach