PHP extract()

La fonction extract() est une fonction intégrée en PHP. La fonction extract() effectue une conversion de tableau en variable. C’est-à-dire qu’il convertit les clés de tableau en noms de variable et les valeurs de tableau en valeur de variable.
 

Syntaxe

extract(array, extract_rules, prefix)

 
 

Paramètres

• array(Obligatoire) : Spécifie le tableau à utiliser.
• extract_rules(Optionnel) : La fonction extract() vérifie les noms de variables non valides et les collisions avec les noms de variables existants. Ce paramètre spécifie comment les noms non valides et en collision sont traités. Voici les valeurs possibles:
  • EXTR_OVERWRITE : Par défaut. En cas de collision, la variable existante est remplacée.
  • EXTR_SKIP – En cas de collision, la variable existante n’est pas remplacée.
  • EXTR_PREFIX_SAME : En cas de collision, le nom de la variable recevra un préfixe.
  • EXTR_PREFIX_ALL : Tous les noms de variables recevront un préfixe.
  • EXTR_PREFIX_INVALID : Seuls les noms de variables invalides ou numériques recevront un préfixe.
  • EXTR_IF_EXISTS : Écrase uniquement les variables existantes dans la table des symboles courante, sinon ne fait rien.
  • EXTR_PREFIX_IF_EXISTS : Ajouter un préfixe aux variables uniquement si la même variable existe dans la table des symboles courante.
  • EXTR_REFS : Extrait des variables comme références. Les variables importées font toujours référence aux valeurs du paramètre de tableau.
• prefix(Optionnel) : Ce paramètre spécifie le préfixe. Le préfixe est automatiquement séparé de la clé du tableau par un caractère de soulignement « _ ». En plus, ce paramètre n’est requis que lorsque le paramètre $extract_rule est défini sur EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID ou EXTR_PREFIX_IF_EXISTS.

 
 

Valeur de retour

Renvoie le nombre de variables extraites en cas de succès
 

Version PHP:

4+
 

Exemple :

Entrée : array("a" => "jean", "b" => "alex", "c" => "bob")
Sortie : $a = "jean" , $b = "alex" , $c = "bob"

Explication: Les clés du tableau deviendront les noms des variables et leurs valeurs seront affectées à ces nouvelles variables.

Le programme suivant montre le fonctionnement de la fonction extract() en PHP:

<?php
	$names = array("a" => "jean", "b" => "alex", "c" => "bob");
	extract($names);
	echo "\$a = $a; \$b = $b; \$c = $c";
?>

 
Sortie:

$a = jean; $b = alex; $c = bob