append

append -- 

void append ( mixed var)

void append ( string varname, mixed var [, bool merge])

割り当てられたテンプレート配列に要素を追加します。もし文字列を追加する場合は、 配列の値としてコンバートされた後に追加されます。配列名/値のペアを明示的に指定するか、それらが格納された連想配列を指定します。配列ではないテンプレート変数に追加した場合、その変数を配列に変換した後で追加されます。 任意の第3パラメータにtrueが渡された場合は、値は現在のテンプレート配列に追加される代わりにマージされます。

テクニカルノート: merge パラメータは配列のキーを尊重するので、インデックスが数値である2つの配列をマージする場合、それらはお互い上書きされるか不連続なキーの配列になるかもしれません。これは、数値のキーを全て削除した後に再びキーに番号付けを行う、phpのarray_merge()関数とは違っています。

例 1. append

<?php
// passing name/value pairs
$smarty->append("Name", "Fred");
$smarty->append("Address", $address);

// passing an associative array
$smarty->append(array("city" => "Lincoln", "state" => "Nebraska"));
?>