end
<<<		 extract in_array
>>>
6.2 Tableaux
6 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_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

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

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
   
<A HREF="function.wddx-deserialize.html"><TT>wddx_deserialize</TT></a>
 */
  $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, large, 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.

<< extract >>
end Tableaux in_array