array_search
指定した値を配列で検索し、見つかった場合に対応するキーを返す
&reftitle.description;
mixedarray_search
mixedneedle
arrayhaystack
boolstrictfalse
haystack において
needle を検索します。
&reftitle.parameters;
needle
探したい値。
needle が文字列の場合、
大文字小文字を区別して比較が行われます。
haystack
配列。
strict
オプションの3番目のパラメータ strict に
&true; が指定された場合、array_search は
identical 要素を
haystack から探します。つまり、
haystack の中で
needle の型に一致するかどうか、
そしてオブジェクトが同一のインスタンスであるかどうかも確認します。
&reftitle.returnvalues;
needle が見つかった場合に配列のキー、
それ以外の場合に &false; を返します。
もし haystack に 1 つ以上の
needle に見つかった場合、
最初にマッチしたキーが返されます。
全てのマッチした値に対するキーを返すためには、代わりに
array_keys にパラメータ
search_value を付けて使用してください。
&return.falseproblem;
&reftitle.changelog;
&Version;
&Description;
5.3.0
他のすべての内部関数と同様、無効なパラメータが渡されたときに
array_search が &null; を返すようになりました。
4.2.0
PHP 4.2.0 以前では、array_search は、
失敗した場合に &false; ではなく &null; を返します。
&reftitle.examples;
array_search の例
'blue', 1 => 'red', 2 => 'green', 3 => 'red');
$key = array_search('green', $array); // $key = 2;
$key = array_search('red', $array); // $key = 1;
?>
]]>
&reftitle.seealso;
array_keys
array_values
array_key_exists
in_array