appendByRef() — 参照として値を追加します。
void appendByRef(string varname,
mixed var,
bool merge);
これを使用して、テンプレートに参照として値を
追加 します。
PHP 5 以降では、appendByRef() はほとんどの場合で不要になりました。
appendByRef() が有用なのは、PHP の配列のインデックスの値を
テンプレートから再代入したい場合などです。オブジェクトのプロパティへの代入は、
デフォルトでこれと同じ挙動になります。
merge パラメータは配列のキーを尊重するので、
インデックスが数値である2つの配列をマージする場合、
それらはお互い上書きされるか不連続なキーの配列になるかもしれません。
これは、数値のキーを全て削除した後に再びキーに番号付けを行う、PHP
の array_merge()
関数とは違っています。
Example 13.2. appendByRef
<?php
// 名前/値 のペアを追加します
$smarty->appendByRef('Name', $myname);
$smarty->appendByRef('Address', $address);
?>
append()、
assign()
および
getTemplateVars()
も参照してください。