PHP array_search()Función

PHP Array ReferenceManual de referencia completo de PHP Array

Ejemplo

Busca el valor "red" en el array y devuelve su clave:

<?php
$a=array("a"=>"red","b"=>"green","c"=>"blue");
echo array_search("red",$a);
?>

Ejecutar ejemplo »

Definición y uso

La función array_search() se usa para buscar un valor en un array y devolver la clave correspondiente. Si no encuentra el valor, devuelve false.

Sintaxis

array_search(mixed $needle, array $haystack, bool $strict = false): int|string|false

Parámetros Descripción
$needle Obligatorio. Especifica el valor a buscar en el array.
$haystack Obligatorio. Especifica el array a ser buscado.
$strict Opcional, por defecto es false, solo compara valores, no tipos. Si este parámetro se establece en TRUE, la función busca elementos en el array cuyo tipo de datos y valor coincidan. Valores posibles:
  • true
  • false - por defecto
Si se establece en true, se comprueba el tipo del valor dado en el array; el número 5 y la cadena 5 son diferentes (ver ejemplo 2).

Detalles técnicos

Valor de retorno: Si se encuentra el valor especificado en el array, devuelve la clave correspondiente; de lo contrario, devuelve FALSE. Si el valor se encuentra más de una vez, devuelve la clave que coincide con el valor encontrado la primera vez.
Versión de PHP: 4.0.5+
Registro de cambios: Si se pasan argumentos inválidos a la función, la función devuelve NULL (esto se aplica a todas las funciones de PHP desde PHP 5.3.0).

Desde PHP 4.2.0, si la búsqueda falla, la función devuelve FALSE, no NULL.

Más ejemplos

Ejemplo

<?php
$numbers = array(1, "2", 3);
$key = array_search(2, $numbers);        // Sin modo estricto, devuelve la clave 1
$key_strict = array_search(2, $numbers, true);  // Con modo estricto, devuelve false
?>

Ejemplo 1

Busca el valor 5 en el array y devuelve su clave (observa ""):

<?php
$a=array("a" => "5", "b" => 5, "c" => "5");
echo array_search(5,$a,true);
?>

Ejecutar ejemplo »

PHP Array ReferenceManual de referencia completo de PHP Array Otras extensiones