Services webmasters
Partenaires
Jeux concours gratuits
 
end
<<<
extract in_array
>>>

7.2 Tableaux
7 Index des fonctions
 Manuel PHP

Introduction
Pré-requis
Installation
Configuration à l'exécution
Types de ressources
Constantes prédefinies
Voir aussi
array_change_key_case
array_chunk
array_combine
array_count_values
array_diff_assoc
array_diff
array_fill
array_filter
array_flip
array_intersect_assoc
array_intersect
array_key_exists
array_keys
array_map
array_merge_recursive
array_merge
array_multisort
array_pad
array_pop
array_push
array_rand
array_reduce
array_reverse
array_search
array_shift
array_slice
array_splice
array_sum
array_unique
array_unshift
array_values
array_walk
array
arsort
asort
compact
count
current
each
end
->extract
in_array
key
krsort
ksort
list
natcasesort
natsort
next
pos
prev
range
reset
rsort
shuffle
sizeof
sort
uasort
uksort
usort

7.2.48 extract() Importe les variables dans la table des symboles

[ Exemples avec extract ]   PHP 3>= 3.0.7, PHP 4

int  extract ( array   var_array , int   extract_type , string   prefix )

extract sert à exporter un tableau vers la table des symboles. Elle prend un tableau associatif var_array , crée les variables dont les noms sont les index de ce tableau, et leur affecte la valeur associée. Pour chaque paire clé/valeur, extract crée une variable, avec les paramètres extract_type et prefix .

Note

Depuis la version 4.0.5, extract retourne le nombre de variables extraites.

Note

EXTR_IF_EXISTS et EXTR_PREFIX_IF_EXISTS ont été introduites en PHP version 4.2.0.

Note

EXTR_REFS a été introduite en PHP 4.3.0.

extract vérifie l'existence de la variable avant de la créer. Le traitement des collisions est déterminé par extract_type . Ce paramètre peut prendre une des valeurs suivantes :

    EXTR_OVERWRITE
    Lors d'une collision, réécrire la variable existante.
    EXTR_SKIP
    Lors d'une collision, ne pas réécrire la variable existante.
    EXTR_PREFIX_SAME
    Lors d'une collision, ajouter le préfixe prefix , et créer une nouvelle variable.
    EXTR_PREFIX_ALL
    Ajouter le préfixe prefix , et créer une nouvelle variable.
    EXTR_PREFIX_INVALID
    Préfixer uniquement les variables aux noms invalides ou numériques avec le préfixe prefix . Ceci a été ajouté en PHP 4.0.5.
    EXTR_IF_EXISTS
    Ecrase la variable uniquement si elle existe déjà dans la table des symboles, et sinon, ne rien faire. Ceci est pratique pour définir une liste de variables valides, puis d'extraire du tableau les valeurs que vous avez déjà définies grâce à $_REQUEST , par exemple. Cette option a été ajoutée en PHP 4.2.0.
    EXTR_PREFIX_IF_EXISTS
    Ne crée que des variables préfixées, si la version non préfixée de la même variable existe dans la table des symboles courante. Cette option a été ajoutée en PHP 4.2.0.
    EXTR_REFS
    Extrait les variables sous forme de références. Cela signifie que les valeurs des variables importées font toujours référence aux valeurs des variables d'origine dans le paramètre var_array . Vous pouvez utiliser cette option seule, ou bien la combiner avec d'autres option avec l'opérateur OR, dans le paramètre extract_type . Cette option a été ajoutée en PHP 4.3.0.

Si extract_type est omis, extract utilise EXTR_OVERWRITE par défaut.

Notez que prefix n'est nécessaire que pour les valeurs de extract_type suivantes : EXTR_PREFIX_SAME , EXTR_PREFIX_ALL , EXTR_PREFIX_INVALID ou EXTR_PREFIX_IF_EXISTS . Le résultat préfixé n'est pas un nom de variable valide, il ne sera pas importé dans la table des symboles.

extract retourne le nombre de variables réellement importées dans la table des symboles.

Une utilisation possible de la fonction extract est l'exportation vers la table des symboles de tableaux de variables retournés par wddx_deserialize .

Exemple avec extract

<?php
/* Supposons que $var_array est un tableau retourné
   par wddx_deserialize() */
  
$taille = "grand";
  
$var_array = array("couleur" => "bleu",
                     
"taille"  => "moyen",
                     
"forme" => "sphere");
  
extract($var_array, EXTR_PREFIX_SAME, "wddx");
  print
"$couleur, $taille, $forme, $wddx_taille\n";
?>

L'exemple ci-dessus affiche :


bleu, grand, sphere, moyen

La variable $taille n'a pas été réécrite, car on avait spécifié le paramètre EXTR_PREFIX_SAME , qui a permis la création $wddx_size . Si EXTR_SKIP avait été utilisé, alors $wddx_size n'aurait pas été créé. Avec EXTR_OVERWRITE , $taille aurait pris la valeur "moyen", et avec EXTR_PREFIX_ALL , les variables créées seraient $wddx_couleur , $wddx_taille et $wddx_forme .

Vous devez utiliser un tableau associatif. Un tableau indexé numériquement ne produira aucun résultat, à moins que vous n'utilisiez l'option EXTR_PREFIX_ALL ou EXTR_PREFIX_INVALID .

Voir aussi compact .

<< extract >>
end Tableaux in_array
Services webmasters
Les manuels
 
CoursPHP.com - Reproduction interdite -