array_search
(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
array_search — Searches the array for a given value and returns the first corresponding key if successful
Description
Searches for needle in haystack.
Parameters
-
needle -
The searched value.
Note:
If
needleis a string, the comparison is done in a case-sensitive manner. -
haystack -
The array.
-
strict -
If the third parameter
strictis set totruethen the array_search() function will search for identical elements in thehaystack. This means it will also perform a strict type comparison of theneedlein thehaystack, and objects must be the same instance.
Return Values
Returns the key for needle if it is found in the
array, false otherwise.
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.
This function may
return Boolean false, but may also return a non-Boolean value which
evaluates to false. Please read the section on Booleans for more
information. Use the ===
operator for testing the return value of this
function.
Examples
Example #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;
?>
See Also
- array_keys() - Return all the keys or a subset of the keys of an array
- array_values() - Return all the values of an array
- array_key_exists() - Checks if the given key or index exists in the array
- in_array() - Checks if a value exists in an array
