array_search
(PHP 4 >= 4.0.5, PHP 5)
array_search — 指定した値を配列で検索し、見つかった場合に対応するキーを返す
haystack において needle を検索し、 配列中に見付かった場合にそのキーを返します。そうでない場合にFALSEを返します。
注意: もし needle が文字列の場合、 大文字小文字を区別して比較が行われます。
注意: PHP 4.2.0 以前では、array_search() は、 失敗した場合に FALSE ではなく NULL を返します。
オプションの3番目のパラメータ strict に TRUE が指定された場合、array_search() は haystack の中で needle の型に一致するかどうかも確認します。
もし haystack に 1 つ以上の needle に見つかった場合、 最初にマッチしたキーが返されます。 全てのマッチした値に対するキーを返すためには、代わりに array_keys() にパラメータ search_value を付けて使用してください。
例 254. array_search() の例
array_keys()、 array_values()、 array_key_exists() および in_array() も参照ください。
array_search — 指定した値を配列で検索し、見つかった場合に対応するキーを返す
説明
mixed array_search ( mixed needle, array haystack [, bool strict] )haystack において needle を検索し、 配列中に見付かった場合にそのキーを返します。そうでない場合にFALSEを返します。
注意: もし needle が文字列の場合、 大文字小文字を区別して比較が行われます。
注意: PHP 4.2.0 以前では、array_search() は、 失敗した場合に FALSE ではなく NULL を返します。
オプションの3番目のパラメータ strict に TRUE が指定された場合、array_search() は haystack の中で needle の型に一致するかどうかも確認します。
もし haystack に 1 つ以上の needle に見つかった場合、 最初にマッチしたキーが返されます。 全てのマッチした値に対するキーを返すためには、代わりに array_keys() にパラメータ search_value を付けて使用してください。
例 254. array_search() の例
<?php
$array = array(0 => 'blue', 1 => 'red', 2 => 'green', 3 => 'red');
$key = array_search('green', $array); // $key = 2;
$key = array_search('red', $array); // $key = 1;
?>
| 警告 |
| この関数は論理値
FALSE を返す可能性がありますが、FALSE として評価される
0 や "" といった値を返す可能性もあります。
詳細については 論理値の
セクションを参照してください。この関数の返り値を調べるには
===演算子 を
使用してください。 |
array_keys()、 array_values()、 array_key_exists() および in_array() も参照ください。
このページでは「PHP関数リファレンス」からarray_searchを検索した結果を表示しています。
Weblioに収録されているすべての辞書からarray_searchを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からarray_search
を検索
Weblioに収録されているすべての辞書からarray_searchを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からarray_search
を検索
- array_searchのページへのリンク
