array_search

PHP マニュアル
前のページ		次のページ

説明

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 を付けて使用してください。

例 1. 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() も参照ください。

前のページ	ホーム	次のページ
array_reverse	上に戻る	array_shift