array_reverse
array_shift
Array Functions
PHP Manual

# array_search

(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

### Descripción

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

Busca en el `pajar` por la `aguja` .

### Lista de parámetros

`aguja`

  El valor a buscar.

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

`pajar`

  La matriz.

`estricto`

  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` .

### Valores retornados

Devuelve la clave de la `aguja` si se encuentra en la matriz, o `FALSE` de lo contrario.

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` .

Warning

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.

### Registro de cambios

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`.

### Ejemplos

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

### Ver también

- array_keys() - Devuelve todas las claves de una matriz
- array_values() - Devuelve todos los valores de una matriz
- array_key_exists() - Comprueba si el índice o clave dada existe en la matriz
- in_array() - Revisa si un valor existe en una matriz

array_reverse
array_shift
Array Functions
PHP Manual