Array Literals

Defining an array in Textwire is done in a similar way as in other languages. Example:

{{ names = ["John", "Jane", "Jack"] }}

<ul>
    @each(name in names)
        <li>{{ name }}</li>
    @end
</ul>

You can access values in an array by using an index. Example:

{{ names = ["John", "Jane", "Jack"] }}

<ul>
    <li>{{ names[0] }}</li> {{-- John --}}
    <li>{{ names[1] }}</li> {{-- Jane --}}
    <li>{{ names[2] }}</li> {{-- Jack --}}
    <li>{{ names[10] }}</li> {{-- nil --}}
</ul>

Out of bounds returns nil

Accessing an array at a non-existent index returns nil instead of resulting in an error.

Indexing strings

You cannot use [number] to access a string character, instead, use at() function.

Prints as comma-separated

Printing an array converts it to comma separated values. Example:

<span>{{ [1, 2, 3] }}</span>

<span>1, 2, 3</span>
<!-- Output -->

Check for nil first

Always check array access with index for nil before using it to prevent using functions on nil errors. Example:

{{ names = [] }}
{{ names[0] ? names[0].upper() : '' }}

No circular references

Assigning an array or object into itself, directly or through nested values, is an error. The assignment is rejected and the template fails with an error message.

{{ a = [1]; a[0] = a; a }}

{{ b = {x: 1}; b.y = b; b }}