(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
array_search — Busca en un array la primera clave asociada al valor
Busca needle
en haystack
.
needle
El valor a buscar.
Nota:
Si
needle
es una string, la comparación se realiza respetando las mayúsculas y minúsculas.
haystack
El array.
strict
Si el tercer argumento strict
vale
true
, entonces array_search() buscará
elementos idénticos en
haystack
. Esto significa que la función
realizará una comparación estricta del tipo
de needle
en haystack
,
y que los objetos provienen de la misma instancia.
Devuelve la clave para needle
si se encuentra
en el array, false
en caso contrario.
Si needle
se encuentra más de una vez en
haystack
, se devuelve la primera clave coincidente. Para encontrar todas las claves correspondientes, utilice la función array_keys() con el argumento opcional
filter_value
.
Esta función puede
devolver el valor booleano false
, pero también puede devolver un valor no booleano que se
evalúa como false
. Por favor lea la sección sobre Booleanos para más
información. Use el operador
=== para comprobar el valor devuelto por esta
función.
Ejemplo #1 Ejemplo con 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;
?>