PHP array_search() 関数

❮ PHP 配列リファレンス

配列の値 "red" を検索し、そのキーを返します:

<?php
$a=array("a"=>"red","b"=>"green","c"=>"blue");
echo array_search("red",$a);
?>
例の実行 »

定義と用法

array_search() 関数は配列の値を検索し、そのキーを返します。


構文

array_search(value,array,strict)

パラメータ 説明
value 必須。検索する値を指定する
array 必須。検索する配列を指定する
strict 任意。このパラメータをTRUEに設定した場合、この関数は、配列内の値とタイプが同じ要素を検索します。 指定可能な値:
  • true
  • false - デフォルト
true に設定した場合、数字 5 は文字列 5 と同値ではなくなります(例2を参照)

技術内容
返り値: 値が配列内にある場合はそのキーを返し、無ければFALSEを返します。 値が配列内に複数見つかった場合は、最初に一致したキーが返されます。
PHP バージョン: 4.0.5+
変更歴 無効なパラメータが渡されると、この関数はNULLを返します(これは5.3.0以降のすべてのPHP関数に適用されます)。

PHP 4.2.0以降、この関数は、失敗した場合にNULLではなくFALSEを返します。

その他の例

例 1

配列から値 5 を検索し、そのキーを返します("" に注意してください):

<?php
$a=array("a"=>"5","b"=>5,"c"=>"5");
echo array_search(5,$a,true);
?>
例の実行 »

❮ PHP 配列リファレンス