appendByRef() — append values by reference


void appendByRef(string varname,
                 mixed var,
                 bool merge);

This is used to append() values to the templates by reference.

Technical Note

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.

Technical Note

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

// appending name/value pairs
$smarty->appendByRef('Name', $myname);
$smarty->appendByRef('Address', $address);


See also append(), assign() and getTemplateVars().