Manuale PHP
Indietro |  | Avanti

# array_search

(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.

## Descrizione

mixed array_search ( mixed ago, array pagliaio [, bool strict] )

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 di `FALSE` 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.

Esempio 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; ?>`

Avvertimento
Questa funzione può restituire il Booleano `FALSE`, ma può anche restituire un valore non-Booleano valutato come `FALSE`, come ad esempio 0 o "". Per favore 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().

Indietro | Partenza | Avanti
array_reverse | Risali | array_shift