(PHP 4 >= 4.0.5, PHP 5, PHP 7)
array_search — Busca un valor determinado en un array y devuelve la primera clave correspondiente en caso de éxito
Busca en el haystack (pajar) por la needle (aguja).
needleEl valor a buscar.
Nota:
Si
needlees una cadena, la comparación es realizada de forma sensible a mayúsculas y minúsculas.
haystackEl array
strict
Si el tercer parámetro, strict, se define como TRUE
entonces la función array_search() también buscará
elementos idénticos en el
haystack. Esto significa que también comprobará los
tipos de datos de la
needle en el haystack,
ya que los objetos deben ser la misma instancia.
Devuelve la clave de la needle si se encuentra en
el array, o FALSE si no.
Si la needle es encontrada en el haystack
más de una vez, se devuelve la primera clave coincidente. Para devolver las claves de
todos los valores coincidentes, se ha de usar en su lugar array_keys()
con el parámetro opcional search_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.
| Versión | Descripción |
|---|---|
| 5.3.0 |
Al igual que con todas las funciones internas de PHP a partir de la versión 5.3.0,
array_search() devuelve NULL si se le pasan parámetros
inválidos.
|
| 4.2.0 |
En versiones de PHP anteriores a 4.2.0, array_search() devuelve NULL
en caso de fallo, en lugar de FALSE.
|
Ejemplo #1 Ejemplo de array_search()
<?php
$array = array(0 => 'azul', 1 => 'rojo', 2 => 'verde', 3 => 'rojo');
$clave = array_search('verde', $array); // $clave = 2;
$clave = array_search('rojo', $array); // $clave = 1;
?>