array_search

Descripción

mixed array_search ( mixed aguja, array pajar [, bool estricto] )

Busca en el pajar por la aguja y retorna la clave de ésta si se encuentra en la matriz, o FALSE de lo contrario.

Nota: Si aguja es una cadena, la comparación es realizada de forma sensible a mayúsculas y minúsculas.

Nota: 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.

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; ?>

Aviso

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().