aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/smarty/smarty/docs/designers/language-builtin-functions/language-function-append.md
blob: 62f2c7e19a2c681b6e423d7f3f3d1ae613962e20 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
{append} {#language.function.append}
========

`{append}` is used for creating or appending template variable arrays
**during the execution of a template**.

> **Note**
>
> Assignment of variables in-template is essentially placing application
> logic into the presentation that may be better handled in PHP. Use at
> your own discretion.

**Attributes:**

   Attribute Name    Type    Required   Default  Description
  ---------------- -------- ---------- --------- ----------------------------------------------------------------------------------------------------
        var         string     Yes       *n/a*   The name of the variable being assigned
       value        string     Yes       *n/a*   The value being assigned
       index        string      No       *n/a*   The index for the new array element. If not specified the value is append to the end of the array.
       scope        string      No       *n/a*   The scope of the assigned variable: \'parent\',\'root\' or \'global\'

**Option Flags:**

    Name    Description
  --------- -----------------------------------------------------
   nocache  Assigns the variable with the \'nocache\' attribute


    {append var='name' value='Bob' index='first'}
    {append var='name' value='Meyer' index='last'}
    // or 
    {append 'name' 'Bob' index='first'} {* short-hand *}
    {append 'name' 'Meyer' index='last'} {* short-hand *}

    The first name is {$name.first}.<br>
    The last name is {$name.last}.

      

The above example will output:


    The first name is Bob.
    The last name is Meyer.

      

See also [`append()`](#api.append) and
[`getTemplateVars()`](#api.get.template.vars).