(PHP 4 >= 4.0.5, PHP 5)
array_search — Busca un valor determinado en un array y devuelve la clave correspondiente en caso de éxito
Busca en el haystack
(pajar) por la needle
(aguja).
needle
El valor a buscar.
Nota:
Si
needle
es una cadena, la comparación es realizada de forma sensible a mayúsculas y minúsculas.
haystack
El array
strict
Si el tercer parámetro strict
, se define como TRUE
entonces la función array_search() también comprobará
por elementos idénticos en el haystack
. Esto significa que también comprobará los
tipos de datos de la
needle
en el haystack
.
Devuelve la clave de la needle
si se encuentra en
el array, o FALSE
de lo contrario.
Si la needle
es encontrada en el haystack
más de una vez, la primera clave coincidente es devuelta. Para devolver las claves de
todos los valores coincidentes, use 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 |
---|---|
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
$matriz = array(0 => 'blue', 1 => 'red', 2 => 'green', 3 => 'red');
$clave = array_search('green', $matriz); // $clave = 2;
$clave = array_search('red', $matriz); // $clave = 1;
?>