PHP 標準関数逆引き辞典

$colors = array(
              "赤" => "FF0000"
            , "緑" => "00FF00"
            , "青" => "0000FF"
          );

$keys = array_keys($colors);

array array_keys(array a)
array array_keys(array a, mixed v)

連想配列 a のキーを全て取得します。

値 v を指定した場合は、その値に関連付いているキーのみを取得します。

$colors = array(
              "赤" => "FF0000"
            , "緑" => "00FF00"
            , "青" => "0000FF"
            , "レッド" => "FF0000"
            , "グリーン" => "00FF00"
            , "ブルー" => "0000FF"
          );

$keys = array_keys($colors, "0000FF");

ソースファイル

$keys[0] は "青" 、$keys[1] は "ブルー" になります。

●引数

a … 連想配列
v … 検索する値

●戻り値

・値 v を指定しない … 全てのキーを格納した配列
・値 v を指定 … その値に関連付いているキーを格納した配列

●バージョン

PHP4 、PHP5

●補足

値 v の判定において、数値と同じ数字の文字列は、その数値と等しくなります。 論理値の場合は、「 false ＝ 0 」、「 true ＝ 0 以外 」になります。

数値     数字文字列     論理値
   0  ＝     "0"    ＝  false
   1  ＝     "1"    ＝  true
 100  ＝   "100"    ＝  true

そのため、次のような場合は全てのキーが取得されます。

$vars = array(
              "integer" => 1
            , "string" => "1"
            , "boolean" => true
        );

$keys = array_keys($vars, 1);

ソースファイル

$keys[0] は "integer" 、$keys[1] は "string" 、$keys[2] は "boolean" になります。