Derniers tutoriels de développement web
 

PHP extract() Function

<Tableau PHP Référence

Exemple

Attribuer les valeurs "Cat" , "Dog" et "Horse" aux variables $ a, $ b et $ c:

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

Définition et utilisation

L' extract() fonction importe les variables dans la table de symboles locaux d'un tableau.

Cette fonction utilise les touches de tableau comme noms de variables et les valeurs que les valeurs des variables. Pour chaque élément, il va créer une variable dans la table des symboles.

Cette fonction retourne le nombre de variables extraites du succès.


Syntaxe

extract( array,extract_rules,prefix )

Paramètre La description
array Champs obligatoires. Indique le tableau à utiliser
extract_rules Optionnel. Les extract() fonction vérifie les noms des variables invalides et les collisions avec des noms de variables existantes. Ce paramètre spécifie comment les noms non valides et entrant en collision sont traités.

Valeurs possibles:

  • EXTR_OVERWRITE - Par défaut. En cas de collision, la variable existante est remplacée
  • EXTR_SKIP - collision frontale, la variable existante ne soit pas remplacé
  • Paramètre EXTR_PREFIX_SAME - collision frontale, le nom de la variable sera donné un préfixe
  • EXTR_PREFIX_ALL - Tous les noms de variables auront un préfixe
  • EXTR_PREFIX_INVALID - Seuls les noms de variables invalides ou numériques sera donné un préfixe
  • EXTR_IF_EXISTS - écrasent Seules les variables existantes dans la table des symboles, sinon ne rien faire
  • EXTR_PREFIX_IF_EXISTS - Seulement ajouter le préfixe à des variables si la même variable existe dans la table des symboles
  • EXTR_REFS - Extraits de variables comme références. Les variables importés font référence encore les valeurs du paramètre de réseau
prefix Optionnel. Si le paramètre EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID ou EXTR_PREFIX_IF_EXISTS sont utilisés dans le paramètre extract_rules, un préfixe spécifié est nécessaire.

Ce paramètre spécifie le préfixe. Le préfixe est séparé automatiquement de la clé du tableau par un caractère de soulignement.

Détails techniques

Valeur de retour: Renvoie le nombre de variables extraites du succès
PHP Version: 4+
changelog: La valeur extract_rules EXTR_REFS a été ajouté en PHP 4.3.

Les valeurs ont été ajoutées des extract_rules EXTR_IF_EXISTS et EXTR_PREFIX_IF_EXISTS en PHP 4.2.

PHP 4.0.5, cette fonction retourne maintenant le nombre de variables extraites.

La valeur extract_rules EXTR_PREFIX_INVALID a été ajouté en PHP 4.0.5.

PHP 4.0.5, la valeur extract_rules EXTR_PREFIX_ALL inclut maintenant des variables numériques aussi bien.

autres exemples

Exemple 1

En utilisant tous les paramètres:

<?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";
?>
»Exécuter exemple

<Tableau PHP Référence