(PHP 4 >= 4.0.5, PHP 5)
array_search — Busca un valor determinado en una matriz y devuelve la clave correspondiente en caso de éxito
Busca en el pajar por la aguja y retorna la clave de ésta si se encuentra en la matriz, o FALSE de lo contrario.
Note: Si aguja es una cadena, la comparación es realizada de forma sensible a mayúsculas y minúsculas.
Note: En versiones de PHP anteriores a 4.2.0, array_search() devuelve NULL en caso de fallo, en lugar de FALSE.
Si el opcional tercer argumento, estricto , se define como TRUE entonces la función array_search() también realizará un chequeo sobre los tipos de datos de aguja en el pajar .
Si la aguja es encontrada en el pajar 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 valor_busqueda .
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;
?>
Esta función puede devolver FALSE, pero también puede devolver un valor no-booleano que será evaluado FALSE, como por ejemplo 0 o "". Por favor, lea la sección Booleans para más información. Utilice el operador === para comprobar el valor devuelto por esta función.
Vea también array_keys(), array_values(), array_key_exists(), y in_array().