append_by_ref()

Description

This is used to append() values to the templates by reference. If you append a variable by reference then change its value, the appended value sees the change as well. For objects, append_by_ref() also avoids an in-memory copy of the appended object. See the PHP manual on variable referencing for an in-depth explanation. If you pass the optional third parameter of TRUE, the value will be merged with the current array instead of appended.

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