(PHP 4 >= 4.0.5, PHP 5)
array_search — Ricerca un dato valore in un array e ne restituisce la chiave corrispondente, se la ricerca ha successo.
Cerca in pagliaio
per trovare
ago
e restituisce la chiave se viene trovato
nell'array, FALSE
altrimenti.
Nota:
Se
ago
è una stringa, il confronto è fatto tenendo conto delle maiuscole/minuscole.
Nota:
Nelle versioni di PHP antecedenti la 4.2.0, array_search() restituisce
NULL
invece diFALSE
in caso di fallimento.
Se il terzo parametro opzionale strict
è impostato a
TRUE
la funzione array_search()
controllerà anche il tipo di ago
nell'array pagliaio
.
Se ago
viene ritrovato in
pagliaio
più di una nolta, viene restituita
la prima chiave trovata. Per restituire le chiavi di tutti i valori, utilizzare
array_keys() con il parametro opzionale
valore_ricerca
.
Example #1 esempio di array_search()
<?php
$array = array(0 => 'blu', 1 => 'rosso', 2 => 'verde', 3 => 'rosso');
$chiave = array_search('verde', $array); // $chiave = 2;
$chiave = array_search('rosso', $array); // $chiave = 1;
?>
Questa funzione può
restituire il Booleano FALSE
, ma può anche restituire un valore non-Booleano valutato
come FALSE
. Fare riferimento alla sezione Booleans per maggiori
informazioni. Usare l'operatore ===
per controllare il valore restituito da questa
funzione.
Vedere anche array_keys(), array_values(), array_key_exists() e in_array().