說明
mixed
array_search ( mixed needle, array haystack [, bool strict] )
在 haystack 中搜尋
needle 參數並在找到的情況下返回鍵名,否則返回 FALSE。
注:
若果 needle 是字串,則比較以區分大小寫的模式進行。
注:
在 PHP 4.2.0 之前,array_search() 在失敗時返回
NULL 而不是 FALSE。
若果可選的第三個參數 strict 為 TRUE,則
array_search() 還將在 haystack
中檢查 needle 的類型。
若果 needle 在
haystack
中出現不止一次,則返回第一個符合的鍵。要返回所有符合值的鍵,應該用
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()。