• « array_reverse
  • array_shift »
  • PHP Manual
  • Funciones de Arrays
  • Busca en un array la primera clave asociada al valor

array_search

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

array_search — Busca en un array la primera clave asociada al valor

Descripción

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

Busca needle en haystack.

Parámetros

needle

El valor a buscar.

Nota:

Si needle es un chaîne de caractères, la comparación se realiza respetando la casilla.

haystack

El array.

strict

Si el tercer argumento strict es true, entonces array_search() buscará elementos idénticos en haystack. Esto significa que esta función realizará una comparación estricta del tipo de needle en haystack, y que los objetos provienen de la misma instancia.

Valores devueltos

Devuelve la clave para needle si es encontrada en el array, false en caso contrario.

Si needle es encontrado más de una vez en haystack, la primera clave coincidente es devuelta. Para encontrar todas las claves correspondientes, utilice en su lugar la función array_keys() con el argumento opcional filter_value.

Advertencia

Esta función puede devolver el valor booleano false, pero también puede devolver un valor no booleano que se evalúa como false. Por favor lea la sección sobre Booleanos para más información. Use el operador === para comprobar el valor devuelto por esta función.

Ejemplos

Ejemplo #1 Ejemplo con array_search()

<?php
$array
= array(0 => 'blue', 1 => 'red', 2 => 'green', 3 => 'red');

$key = array_search('green', $array); // $key = 2;
print_r($key);

$key = array_search('red', $array); // $key = 1;
print_r($key);
?>

Ver también

  • array_keys() - Devuelve todas las claves o un conjunto de las claves de un array
  • array_values() - Devuelve todos los valores de un array
  • array_key_exists() - Verifica si una clave existe en un array
  • in_array() - Indica si un valor pertenece a un array