(PHP 3> = 3.0.7, PHP 4, PHP 5)
extract - Variați importul dintr-un tablou în tabela simbolică curentă.
Descriere int extract (array var_array [, int extract_type [, prefix string]])
# 13; Această funcție este utilizată pentru a importa variabile dintr-o matrice în tabela simbolică curentă. Este nevoie de o matrice asociativă ca parametru var_array și îi tratează cheile ca nume de variabile și valori ca valori variabile. Pentru fiecare pereche cheie / valoare, va fi creată o variabilă în tabela simbolică curentă, în funcție de parametrii extract_type și prefix.
Notă: Din versiunea 4.0.5, această funcție returnează numărul de variabile extrase.
Notă: EXTR_IF_EXISTS și EXTR_PREFIX_IF_EXISTS au fost adăugate în versiunea 4.2.0.
Notă: EXTR_REFS a fost adăugat în versiunea 4.3.0.
# 13; extract () verifică fiecare cheie pentru a fi adecvată ca nume de variabilă. Această funcție gestionează de asemenea numele de coliziune dacă cheia corespunde cu numele unei variabile deja existente în tabela simbolică curentă. Metoda de manipulare a cheilor numerice / necorespunzătoare și a coliziunilor numelor stabilește parametrul extract_type. Poate lua una dintre următoarele valori:
# 13; Dacă există o variabilă cu acest nume, aceasta va fi realocată.
# 13; Dacă există o variabilă cu acest nume, valoarea sa anterioară va fi păstrată.
Dacă există o variabilă cu acest nume, un prefix specificat de parametrul prefixului va fi adăugat la numele său.
# 13; Adăugați prefixul prefixului la toate numele de variabile. De la PHP 4.0.5, include și numele numerice.
# 13; Adăugați prefixul prefixului numai la numele variabilelor inacceptabile / numerice. Acest steag a fost adăugat în PHP 4.0.5.
# 13; Reataționați numai variabilele deja existente în tabelul cu simboluri actuale, altfel nu faceți nimic. Acest lucru este util pentru determinarea listei variabilelor eligibile și pentru extragerea numai acele variabile pe care le-ați definit de $ _REQUEST de tip matrice, de exemplu. Acest steag a fost adăugat în PHP 4.2.0.
# 13; Crearea variabilelor ale căror nume încep cu prefixul numai dacă numele variabilei nu este precedat de prefix. este definită în tabelul de caractere curent. Acest steag a fost adăugat în PHP 4.2.0.
# 13; Extrageți variabilele ca referințe. Aceasta înseamnă că valorile acestor variabile se vor referi în continuare la valorile array var_array. Puteți folosi acest steag separat sau îl puteți combina cu ceilalți utilizând OR. Acest steag a fost adăugat în PHP 4.3.0.
# 13; În cazul în care tipul de extragere nu este definit, acesta este tratat ca EXTR_OVERWRITE.
# 13; Rețineți că prefixul are o valoare numai dacă extract_type este setat la EXTR_PREFIX_SAME. EXTR_PREFIX_ALL. EXTR_PREFIX_INVALID sau EXTR_PREFIX_IF_EXISTS. Dacă, ca rezultat al adăugării unui prefix, nu se obține un nume valabil pentru variabila, acesta nu va fi importat în tabela simbolică curentă.
# 13; extract () returnează numărul de variabile importate cu succes în tabela de simboluri.
# 13; Nu utilizați funcția extract () pentru date neconfirmate, cum ar fi intrarea utilizatorului ($ _GET.). Dacă faceți acest lucru, de exemplu, pentru a porni temporar vechiul cod care utilizează register_globals. utiliza indicatorul extract_type corespunzător, care nu ar realocați deja stabilite variabile, cum ar fi EXTR_SKIP și asigurați-vă că verificați conținutul matrice $ _SERVER. $ _SESSION. $ _COOKIE. $ _POST și $ _GET în această ordine.
# 13; Funcția extract () poate fi, de asemenea, utilizată pentru a importa variabilele conținute în matricea asociativă returnată de wddx_deserialize () în tabela simbolică curentă.
Exemplul 1. Exemplu de utilizare a extractului ()
/ * Să presupunem că $ var_array este o matrice obținută ca rezultat
wddx_deserialize * /
$ size = "mare";
$ var_array = array ("culoare" => "albastru",
"dimensiune" => "mediu",
"formă" => "sferă");
extrageți ($ var_array.EXTR_PREFIX_SAME. "wddx");
echo "$ color, $ size, $ shape, $ wddx_size
„;
Rezultatul acestui exemplu: