Ultimele tutoriale de dezvoltare web
 

PHP extract() Function

<PHP Array Reference

Exemplu

Atribuirea valorilor "Cat" , "Dog" și "Horse" la variabilele $ a, $ b și $ c:

<?php
$a = "Original";
$my_array = array("a" => "Cat" ,"b" => "Dog" , "c" => "Horse");
extract($my_array);
echo "\$a = $a; \$b = $b; \$c = $c";
?>
Run exemplu »

Definiție și utilizare

extract() funcția importă variabile în tabela de simboluri locale dintr - o matrice.

Această funcție utilizează chei de matrice ca nume de variabile și valori ca valori variabile. Pentru fiecare element va crea o variabilă în tabela de simboluri curent.

Această funcție returnează numărul de variabile extrase pe succes.

Sintaxă

extract( array,extract_rules,prefix )

Parametru Descriere
array Necesar. Specifică matrice pentru a utiliza
extract_rules Opțional. De extract() verifică funcție pentru numele variabilelor invalide și coliziuni cu nume de variabile existente. Acest parametru specifică modul în care sunt tratate nume invalide și coliziunea.

Valori posibile:

  • EXTR_OVERWRITE - implicit. La coliziune, variabila existentă este suprascrisă
  • EXTR_SKIP - în caz de ciocnire, variabila existentă nu este suprascrisă
  • EXTR_PREFIX_SAME - în caz de ciocnire, numele variabilei va fi dat un prefix
  • EXTR_PREFIX_ALL - Toate numele variabilelor vor primi un prefix
  • EXTR_PREFIX_INVALID - numele variabilelor Numai invalide sau numerice se va da un prefix
  • EXTR_IF_EXISTS - suprascrie numai variabilele existente în tabela de simboluri curent, în caz contrar nu fac nimic
  • EXTR_PREFIX_IF_EXISTS - Doar adăugați prefix la variabile dacă există aceeași variabilă în tabela de simboluri curent
  • EXTR_REFS - Extrage variabile ca referințe. Variabilele importate sunt în continuare referire la valorile parametrului matrice
prefix Opțional. Dacă EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID sau EXTR_PREFIX_IF_EXISTS sunt utilizate în parametrul extract_rules, este necesar un prefix specificat.

Acest parametru specifică prefixul. Prefixul este separat în mod automat din cheie matrice cu un caracter de subliniere.

Detalii tehnice

Întoarcere Valoare: Returnează numărul de variabile extras pe succes
Versiune PHP: 4+
Changelog: The extract_rules valoare EXTR_REFS a fost adăugat în PHP 4.3.

Valorile de extract_rules EXTR_IF_EXISTS și EXTR_PREFIX_IF_EXISTS au fost adăugate în PHP 4.2.

Începând cu PHP 4.0.5, această funcție returnează acum numărul de variabile extrase.

EXTR_PREFIX_INVALID Valoarea extract_rules a fost adăugat în PHP 4.0.5.

De la PHP 4.0.5, The EXTR_PREFIX_ALL valoarea extract_rules include acum variabile numerice, de asemenea.

Mai multe exemple

Exemplul 1

Folosind toți parametrii:

<?php
$a = "Original";
$my_array = array("a" => "Cat" , "b" => "Dog" , "c" => "Horse");

extract($my_array, EXTR_PREFIX_SAME, "dup");

echo "\$a = $a; \$b = $b; \$c = $c; \$dup_a = $dup_a";
?>
Run exemplu »
<PHP Array Reference