Función array_search() de PHP

Funciones de array en PHP

Ejemplo

Buscar el valor clave "red" en el array y devolver su nombre de clave:

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

Ejemplo de ejecución

Definición y uso

La función array_search() busca un valor clave en un array y devuelve el nombre de la clave correspondiente.

Descripción detallada

La función array_search() con in_array() De la misma manera, encontrar un valor clave en un array. Si encuentra el valor, se devuelve el nombre de la clave del elemento coincidente. Si no lo encuentra, devuelve false.

Antes de PHP 4.2.0, la función devolvía null en caso de fallo en lugar de false.

Si el tercer parámetro strict Si se especifica en true, solo se devuelve el nombre de la clave del elemento correspondiente si tanto el tipo de datos como el valor coinciden.

Sintaxis

array_search(value,array,strict)
Parámetros Descripción
value Requerido. Especifica el valor clave que se buscará.
array Requerido. Especifica el array que se buscará.
strict

Opcional. Si este parámetro se establece en TRUE, la función busca elementos en el array que tengan tanto el tipo de datos como el valor coincidentes. Valores posibles:

  • true
  • false - predeterminado

Si se establece en true, se verifica el tipo de valor dado en el array, el número 5 y la cadena 5 son diferentes (ver ejemplo 2).

Detalles técnicos

Valor devuelto:

Si se encuentra el valor clave especificado en el array, se devuelve el nombre de la clave correspondiente; de lo contrario, se devuelve FALSE.

Si se encuentra el valor clave especificado más de una vez en el array, se devuelve el nombre de la clave que coincide con la primera coincidencia.
Versión de PHP: 4.0.5+
Registro de actualizaciones:

Si se pasan parámetros 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 en lugar de NULL.

Más ejemplos

Ejemplo 1

Buscar un valor clave 5 en el array y devolver su nombre de clave (notar ""):

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

Ejemplo de ejecución

Funciones de array en PHP