(PHP 4 >= 4.0.5, PHP 5, PHP 7)
array_search — Searches the array for a given value and returns the first corresponding key if successful
Searches for needle
in haystack
.
needle
The searched value.
Notă:
If
needle
is a string, the comparison is done in a case-sensitive manner.
haystack
The array.
strict
If the third parameter strict
is set to TRUE
then the array_search() function will search for
identical elements in the
haystack
. This means it will also perform a
strict type comparison of the
needle
in the haystack
,
and objects must be the same instance.
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.
Această funcție poate întoarce valoarea Boolean FALSE
, dar poate de
asemenea întoarce o valoare non-Boolean care evaluează în FALSE
. Vă rugăm să
citiți secțiunea despre tipul Boolean
pentru informații suplimentare. Utilizați
operatorul === pentru a
verifica valoarea întoarsă de această funcție.
Versiune | Descriere |
---|---|
5.3.0 |
As with all internal PHP functions as of 5.3.0,
array_search() returns NULL if invalid parameters
are passed to it.
|
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;
?>