Funzione array_search() in PHP

Esempio

Cerca il valore chiave "red" nell'array e restituisce il nome della chiave:

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

Esempio di esecuzione

Definizione e uso

La funzione array_search() ricerca un valore chiave in un array e restituisce il nome della chiave corrispondente.

Spiegazione dettagliata

La funzione array_search() è in_array() Come fare una ricerca di un valore chiave in un array. Se trova il valore, viene restituito il nome della chiave dell'elemento corrispondente. Se non trova il valore, viene restituito false.

Prima di PHP 4.2.0, la funzione restituiva null invece di false in caso di fallimento.

Se il terzo parametro strict Se impostato su true, restituisce il nome dell'elemento solo se il tipo dei dati e il valore coincidono.

Sintassi

array_search(value,array,strict)
Parametro Descrizione
value Obbligatorio. Specifica il valore chiave da cercare.
array Obbligatorio. Specifica l'array da cercare.
strict

Opzionale. Se il parametro viene impostato su TRUE, la funzione cerca nell'array elementi con dati tipo e valore coincidenti. Valori possibili:

  • true
  • false - predefinito

Se impostato su true, la funzione verifica il tipo del valore dato nell'array, il numero 5 e la stringa 5 sono diversi (vedi esempio 2).

Dettagli tecnici

Valore di ritorno:

Se viene trovata la chiave valore specificata nell'array, viene restituito il nome della chiave corrispondente, altrimenti viene restituito FALSE.

Se viene trovata la chiave valore più di una volta nell'array, viene restituito il nome della chiave corrispondente alla prima occorrenza.

Versione PHP: 4.0.5+
Log delle modifiche:

Se si passano parametri non validi alla funzione, la funzione restituisce NULL (questo si applica a tutte le funzioni PHP a partire da PHP 5.3.0).

A partire da PHP 4.2.0, se la ricerca fallisce, la funzione restituisce FALSE invece di NULL.

Più esempi

Esempio 1

Cerca il valore chiave 5 nell'array e restituisci il nome della chiave (attenzione ""):

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

Esempio di esecuzione