PHP 手冊
上一頁 |  | 下一頁

# array_search

(PHP 4 >= 4.0.5, PHP 5)

array_search -- Searches the array for a given value and returns the corresponding key if successful

## Description

mixed array_search ( mixed needle, array haystack [, bool strict])

Searches haystack for needle and returns the key if it is found in the array, `FALSE` otherwise.

> 備注: If needle is a string, the comparison is done in a case-sensitive manner.

> 備注: Prior to PHP 4.2.0, array_search() returns `NULL` on failure instead of `FALSE`.

If the optional third parameter strict is set to `TRUE` then the array_search() will also check the types of the needle in the haystack.

If needle is found in haystack more than once, the first matching key is returned. To return the keys for all matching values, use array_keys() with the optional search_value parameter instead.

示範 1.array_search() example
`<?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或 ""請參考Booleans此節有更多資訊。使用 === 運算子來測試這個函數的回傳值。

See also array_keys(), array_values(), array_key_exists(), and in_array().

上一頁 | 最開頭 | 下一頁
array_reverse | 上一層 | array_shift