¿Buscar un valor determinado en una matriz y devolver la primera clave correspondiente si tiene éxito?

array_search

(PHP 4 gt; = 4.0.5, PHP 5, PHP 7)

array_search — Busca un valor determinado en una matriz, si Si tiene éxito, devuelve el primer nombre de clave correspondiente

Descripción

array_search (mixto $aguja, matriz $haystack [, bool $strict = false]): mixto

Aguja en un pajar, busque la aguja (parámetro de la aguja) en el pajar.

Parámetro

aguja

El valor a buscar.

Nota:

Si la aguja es una cuerda, la comparación se realiza distinguiendo entre mayúsculas y minúsculas.

pajar

Esta matriz.

estricto

Si el tercer argumento opcional estricto es verdadero, array_search() buscará elementos idénticos en el pajar. Esto significa que el tipo de aguja en el pajar también se compara estrictamente y los objetos deben ser de la misma instancia.

Valor de retorno

Si se encuentra la aguja, devuelve su clave; de ​​lo contrario, devuelve falso.

Si la aguja aparece más de una vez en el pajar, se devuelve la primera clave coincidente. Para devolver todas las claves que coinciden con un valor, se debe utilizar array_keys() con el parámetro search_value opcional.

Advertencia

Esta función puede devolver el valor booleano falso, pero también puede devolver un valor no booleano equivalente a falso. Lea el capítulo Tipos booleanos para obtener más información. El valor de retorno de esta función debe probarse utilizando el operador ===.

Registro de cambios

Descripción de la versión

5.3.0 Al igual que con todas las funciones internas de PHP a partir de 5.3.0, array_search() devuelve nulo si se pasan parámetros no válidos a ello.