(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).
El valor a buscar.
Note:
Si needle es una cadena, la comparación es realizada de forma sensible a mayúsculas y minúsculas.
El array
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 quizá devuelve Boolean FALSE, pero quizá también devuelve un valor non-Boolean que se evaluará como FALSE, como 0 o "". Por favor lea la sección en Booleans para más información. Use el operador === para testear 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. |
Example #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;
?>