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