Affectez les valeurs clés « Chat », « Chien » et « Cheval » aux variables $a, $b et $c :
<?php $a = " Original " ; $my_array = array ( " a " = > " Chat " , " b " = > " Chien " , " c " => " Cheval " ) extrait ( $my_array ) ; " $ a = $a ; $ b = $b ; $ c = $c " ? >La fonction extract() importe les variables d'un tableau dans la table des symboles actuelle.
Cette fonction utilise le nom de la clé du tableau comme nom de variable et la valeur de la clé du tableau comme valeur de variable. Pour chaque élément du tableau, une variable correspondante sera créée dans la table des symboles actuelle.
Cette fonction renvoie le nombre de variables définies avec succès.
extraire ( tableau, extract_rules, préfixe )
| paramètre | décrire |
|---|---|
| tableau | Requis. Spécifie le tableau à utiliser. |
| extraire_rules | Facultatif. La fonction extract() vérifiera si chaque nom de clé est un nom de variable légal et vérifiera également s'il est en conflit avec un nom de variable existant dans la table des symboles. La gestion des noms de clés illégaux et conflictuels sera déterminée en fonction de ce paramètre. Valeurs possibles : EXTR_OVERWRITE - Par défaut. En cas de conflit, les variables existantes sont écrasées. EXTR_SKIP - N'écrasez pas les variables existantes en cas de conflit. EXTR_PREFIX_SAME - Préfixez le nom de la variable avec un préfixe en cas de conflit. EXTR_PREFIX_ALL - Ajoutez un préfixe à tous les noms de variables. EXTR_PREFIX_INVALID - Préfixe uniquement les noms de variables illégaux ou numériques. EXTR_IF_EXISTS - Écrasez les valeurs des variables du même nom uniquement si elles existent déjà dans la table des symboles actuelle. D'autres ne sont pas traités. EXTR_PREFIX_IF_EXISTS - Crée un nom de variable avec un préfixe ajouté uniquement si une variable portant le même nom existe déjà dans la table des symboles actuelle. Les autres ne seront pas traités. EXTR_REFS - Extrait les variables comme références. La variable importée fait toujours référence à la valeur du paramètre array. |
| préfixe | Facultatif. Le préfixe est obligatoire si la valeur du paramètre extract_rules est EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID ou EXTR_PREFIX_IF_EXISTS. Ce paramètre spécifie le préfixe. Un trait de soulignement est automatiquement ajouté entre le préfixe et le nom de la clé du tableau. |
| Valeur de retour : | Renvoie le nombre de variables définies avec succès. |
|---|---|
| Version PHP : | 4+ |
| Journal de mise à jour : | La valeur de extract_rules EXTR_REFS est nouvelle dans PHP 4.3. Les valeurs de extract_rules EXTR_IF_EXISTS et EXTR_PREFIX_IF_EXISTS sont nouvelles dans PHP 4.2. Depuis PHP 4.0.5, cette fonction renvoie le nombre de variables définies avec succès. La valeur de extract_rules EXTR_PREFIX_INVALID est nouvelle dans PHP 4.0.5. Depuis PHP 4.0.5, la valeur de extract_rules EXTR_PREFIX_ALL contient également des variables numériques. |
Utilisez tous les paramètres :
<?php$a = "Original";$my_array = array("a" => "Cat", "b" => "Chien", "c" => "Cheval");extract($my_array, EXTR_PREFIX_SAME, "dup");echo "$a = $a; $b = $b; $c = $c; $dup_a = $dup_a";?>