appendByRef() — append values by reference
void appendByRef(string varname,
                 mixed var,
                 bool merge);
   This is used to
   append() values
   to the templates by reference.
  
     With the introduction of PHP5, appendByRef() is not necessary for most
     intents and purposes. appendByRef() is useful if you want a PHP array index value
     to be affected by its reassignment from a template. Assigned object properties behave
     this way by default.
   
  The merge parameter respects array keys, so if
  you merge two numerically indexed arrays, they may overwrite each other
  or result in non-sequential keys. This is unlike the PHP
  
  array_merge() function
   which wipes out numerical keys and renumbers them.
 
Example 14.5. appendByRef
<?php
// appending name/value pairs
$smarty->appendByRef('Name', $myname);
$smarty->appendByRef('Address', $address);
?>
   
   See also
   append(),
  assign()
  and
  getTemplateVars().