PHP マニュアル: 配列からキーを取り出す

説明

intstringnull key(arrayobject $array)

key は、現在の配列位置における連想配列要素のキーを返します。

パラメータ

array: 配列。

戻り値

key 関数は、内部ポインタが現在指している配列要素のキーを返します。ポインタを移動することはありません。内部ポインタが要素リストの末尾にいる場合や配列が空の場合は key は null を返します。

変更履歴

バージョン	説明
8.1.0	この関数を object に対してコールすることは、推奨されなくなりました。 object に対して最初に get_mangled_object_vars を使って配列に変換するか、ArrayIterator のような Iterator を実装したクラスのメソッドを使ってください。
7.4.0	SPL クラスのインスタンスは、プロパティを持たない空のオブジェクトのように扱われるようになりました。これより前のバージョンでは、この関数と同じ名前の Iterator のメソッドをコールしていました。

例

例1 key の例

<?php
$array = array(
    'fruit1' => 'リンゴ',
    'fruit2' => 'オレンジ',
    'fruit3' => 'ブドウ',
    'fruit4' => 'リンゴ',
    'fruit5' => 'リンゴ');

// このループは値が "リンゴ" である
// 全ての連想配列のキーを表示します
while ($fruit_name = current($array)) {
    if ($fruit_name == 'リンゴ') {
        echo key($array), "\n";
    }
    next($array);
}
?>

上の例の出力は以下となります。

fruit1
fruit4
fruit5

参考

current
next
array_key_first
foreach