PHP array_search: căutați o valoare într-un matrice

Una dintre principalele operațiuni atunci când lucrați cu matrice este de a căuta o valoare specifică. Funcția PHP array_search () este folosită pentru aceasta. Este capabil să proceseze colecțiile unidimensionale și asociative, returnând cheia valorii căutată dacă se află în matrice.

sintaxă

Descrierea formală a funcției array_search () din PHP arată astfel:

mix array_search (valoare mixtă, array $ collection [bool strict])

Parametrii de intrare:

• $ collection - matricea în care se va efectua căutarea;
• valoare - valoarea dorită de orice tip;
• strict este un steag logic opțional care stabilește un mecanism de comparare strict în ceea ce privește tipurile.

Mecanismul de lucru

Funcția PHP array_search () compară alternativ valoarea cu toate valorile din matricea de colectare. În mod prestabilit, comparația este efectuată fără a lua în considerare tipurile de operanzi. Puteți schimba această setare prin setarea steagului strict la TRUE. Comparația de șiruri de caractere este sensibilă la minuscule.

Dacă se găsește o potrivire, cheia corespunzătoare elementului găsit este returnată și funcția este terminată. Prin urmare, nu poate fi folosit pentru a detecta o manifestare multiplă a valorii solicitate într-o matrice.

Dacă nu se găsește niciun rezultat, funcția va returna o valoare booleană FALSE.

Pentru a verifica rezultatul returnat este necesar prin intermediul operatorului de egalitate strictă (===). Acest lucru este important, deoarece funcția poate returna o valoare care este convertită la FALSE, de exemplu, 0 sau un șir gol.

Exemple de utilizare

Exemplul 1. Dacă transferați o matrice multidimensională funcției PHP array_search (), rezultatul operației va fi cheia elementului pe care îl căutați.

 "de iarnă", "Season2" => "de primăvară", "season3" => "de vară", "season4" => "toamna") - $ result1 = array_search ( " iarnă "$ array) - $ result2 = array_search (" de vară "$ array) - $ result3 = array_search (" aprilie“, $ array) -?>

În acest exemplu, $ result1 variabilă va fi setat la „season1“, $ result2 este egal cu „season3“, și va fi atribuit $ result3 boolean FALSE, dar ca „aprilie“ șir de caractere care nu se găsește în matricea originală.

Exemplul 2. Funcția PHP array_search () poate gestiona o matrice unidimensională, numărându-și cheile în ordinea numerelor index.

$ Variabila Rezultatul este setat la 1, în conformitate cu punctul index „vânătorul“ în matrice $ matrice.

Exemplul 3. Eroare posibilă în analiza rezultatului.

 "Washington", 1 => "Adams", 2 => "Jefferson", 3 => "Madison", 4 => "Monroe") - $ rezultat = array_search ( „Washington "președinți $) -Dacă ($ rezultat) {echo!" G. Washington, nu a fost primul președinte al SUA „-}>?

Astfel, fără a verifica rezultatul cu egalitate strictă, puteți obține un mesaj neașteptat că George Washington nu a fost primul președinte al Statelor Unite.

Exemplul 4. Este returnată numai cheia primului meci detectat.

În ciuda faptului că valoarea găsită se găsește de trei ori în matrice, funcția returnează doar primul rezultat găsit - 0. Pentru a căuta mai multe potriviri, se recomandă utilizarea funcției PHP array_keys ().