aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/smarty/smarty/docs/programmers/api-functions/api-append.md
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/smarty/smarty/docs/programmers/api-functions/api-append.md')
-rw-r--r--vendor/smarty/smarty/docs/programmers/api-functions/api-append.md61
1 files changed, 61 insertions, 0 deletions
diff --git a/vendor/smarty/smarty/docs/programmers/api-functions/api-append.md b/vendor/smarty/smarty/docs/programmers/api-functions/api-append.md
new file mode 100644
index 000000000..b94586417
--- /dev/null
+++ b/vendor/smarty/smarty/docs/programmers/api-functions/api-append.md
@@ -0,0 +1,61 @@
+append()
+
+append an element to an assigned array
+
+Description
+===========
+
+void
+
+append
+
+mixed
+
+var
+
+void
+
+append
+
+string
+
+varname
+
+mixed
+
+var
+
+bool
+
+merge
+
+If you append to a string value, it is converted to an array value and
+then appended to. You can explicitly pass name/value pairs, or
+associative arrays containing the name/value pairs. If you pass the
+optional third parameter of TRUE, the value will be merged with the
+current array instead of appended.
+
+NOTE.PARAMETER.MERGE
+
+
+ <?php
+ // This is effectively the same as assign()
+ $smarty->append('foo', 'Fred');
+ // After this line, foo will now be seen as an array in the template
+ $smarty->append('foo', 'Albert');
+
+ $array = array(1 => 'one', 2 => 'two');
+ $smarty->append('X', $array);
+ $array2 = array(3 => 'three', 4 => 'four');
+ // The following line will add a second element to the X array
+ $smarty->append('X', $array2);
+
+ // passing an associative array
+ $smarty->append(array('city' => 'Lincoln', 'state' => 'Nebraska'));
+ ?>
+
+
+
+See also [`appendByRef()`](#api.append.by.ref),
+[`assign()`](#api.assign) and
+[`getTemplateVars()`](#api.get.template.vars)