PHP extract()Fonctions

PHP Array ReferenceRéférence complète des tableaux PHP

Exemples

Affectez 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 l'exemple »

Définition et utilisation

La fonction extract() importe les variables d'un tableau dans la table des symboles actuelle.

Cette fonction utilise les noms des clés du tableau comme noms de variables et les valeurs des clés du tableau comme valeurs de variables. Pour chaque élément du tableau, une variable correspondante est créée dans la table des symboles actuelle.

Cette fonction retourne le nombre de variables définies avec succès.

Syntaxe

extract(array,extract_rules,prefix)

Parameters Description
array Obligatoire. Spécifie le tableau à utiliser.
extract_rules Facultatif. La fonction extract() vérifie si chaque nom de clé est un nom de variable valide et aussi s'il entre en conflit avec des noms de variables existants dans la table des symboles. La gestion des noms de clés invalides et en conflit est déterminée par ce paramètre.

Valeurs possibles :

  • EXTR_OVERWRITE - Par défaut. Écrase les variables existantes en cas de conflit.
  • EXTR_SKIP - N'écrase pas les variables existantes en cas de conflit.
  • EXTR_PREFIX_SAME - En cas de conflit, ajoute le préfixe au début du nom de la variable.
  • EXTR_PREFIX_ALL - Ajoute le préfixe au début de tous les noms de variables.
  • EXTR_PREFIX_INVALID - Ajoute le préfixe uniquement aux noms de variables invalides ou numériques.
  • EXTR_IF_EXISTS - Écrase uniquement les valeurs des variables qui existent déjà dans la table des symboles actuelle. Toutes les autres sont ignorées.
  • EXTR_PREFIX_IF_EXISTS - Crée des noms de variables préfixés uniquement lorsqu'une variable portant le même nom existe déjà dans la table des symboles actuelle. Toutes les autres sont ignorées.
  • EXTR_REFS - Extrait les variables sous forme de références. Les variables importées font toujours référence aux valeurs du paramètre de tableau.
préfixe Facultatif. Si la valeur du paramètre extract_rules est EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID ou EXTR_PREFIX_IF_EXISTS, alors le préfixe est requis.

Ce paramètre spécifie le préfixe. Un trait de soulignement est automatiquement ajouté entre le préfixe et le nom de clé du tableau.

Détails techniques

Valeur de retour : Retourne le nombre de variables définies avec succès.
Version de PHP : 4+
Journal des modifications : extract_rulesLa valeur EXTR_REFS a été ajoutée en PHP 4.3.

extract_rulesLes valeurs EXTR_IF_EXISTS et EXTR_PREFIX_IF_EXISTS ont été ajoutées en PHP 4.2.

Depuis PHP 4.0.5, cette fonction retourne le nombre de variables définies avec succès.

extract_rulesLa valeur EXTR_PREFIX_INVALID a été ajoutée en PHP 4.0.5.

Depuis PHP 4.0.5,extract_rulesLa valeur EXTR_PREFIX_ALL inclut aussi les variables numériques.

Plus d’exemples

Exemple 1

Utilisez 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 l'exemple »

PHP Array ReferenceRéférence complète des tableaux PHP Autres extensions