Sommaire
Tableaux
array
array_chunk
array_count_values
array_diff
array_filter
array_flip
array_fill
array_intersect
array_keys
array_map
array_merge
array_merge_recursive
array_multisort
array_pad
array_pop
array_push
array_reverse
array_reduce
array_rand
array_shift
array_slice
array_splice
array_sum
array_unique
array_unshift
array_values
array_walk
arsort
asort
compact
count
current
each
end
extract
in_array
array_search
key
krsort
ksort
list
natsort
natcasesort
next
pos
prev
range
reset
rsort
shuffle
sizeof
sort
uasort
uksort
usort
|
6.2.35 extract[ Exemples avec extract ] PHP 3>= 3.0.7, PHP 4 >= 4.0.0Description
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.
|
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.
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 ou EXTR_PREFIX_INVALID. 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 <function>wddx_deserialize</function> */ $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 va afficher
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.
|