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); ?>
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:
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); ?>