Name
append_by_ref() — Ajoute des valeurs par référence
Description
void append_by_ref(string varname,
mixed var,
bool merge);
Utilisée pour ajouter des valeurs à un
template par référence plutôt que par copie.
Si vous ajoutez une variable par référence puis changez sa
valeur, le changement est aussi répercuté sur la valeur assignée.
Pour les objets,
append_by_ref() ne fait pas de copie en mémoire de l'objet
assigné. Voir la documentation PHP pour plus d'informations sur les
références de variable.
Si vous passez le troisième paramètre à TRUE, la valeur
sera fusionnée avec le tableau courant plutôt que d'être ajoutée.
Note technique
Le paramètre merge respecte les clés du tableau,
donc, si vous fusionnez deux tableaux indexés numériquement, ils peuvent
se recouvrir les uns les autres ou aboutir à des clés non séquentielles. Ceci
est diférent de la fonction PHP array_merge()
qui élimine des clés numériques et les renumérote.
Example 13.2. Exemple avec append_by_ref
<?php
// ajoute des paires nom/valeur
$smarty->append_by_ref('Nom',$myname);
$smarty->append_by_ref('Adresse',$address);
?>
Voir aussi
append(),
assign() et
get_template_vars().