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
.
|