Skip to main content
Version: v2

Literals

String literals​

You can use string literals and concatenate them with other strings. You can use double or single quotes for strings. Here is an example of using string literals:

{{ "Hello" + 'World!' }}

When you print a string, it will be automatically escaped. If you want to print a string without escaping it, you can use the a raw() function on strings. Example: {{ "<h1>Test</h1>".raw() }}

Integer literals​

You can use integer literals and perform arithmetic operations with them. Here is an example of using integer literals:

<span>{{ 1 + 2 }}</span>

Nil literal​

You can use nil literal to check if a variable is nil. Here is an example of using nil literal:

@if(nil)
    <p>It will not be displayed</p>
@end

Float literals​

You can use float literals and perform arithmetic operations with them. Here is an example of using float literals:

<span>{{ 1.534 + 2.5 }}</span>
Precision limit

Most languages (including Textwire) use IEEE 754 standard for floating-point numbers. These floating-point types have a finite precision and are unable to accurately represent more than approximately 15-17 digits. For example 1234567890.1234567890 will be rounded to 1234567890.1234567 in Textwire because of the precision limit of floating-point numbers. If you need to work with large numbers, you can keep them as strings.

Boolean literals​

You can use boolean literals to check if a variable is true or false. Here is an example of using boolean literals:

@if(true)
    <p>Is tall</p>
@end

Array literals​

Defining an array in Textwire is done is a similar way as in other languages. Here is an example of defining an array:

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

<ul>
    @each(name in names)
        <li>{{ name }}</li>
        <li>{{ loop.index }}</li> <!-- Index of the current item -->
    @end
</ul>

You can access values in an array by using an index. Here is an example of accessing values in an array:

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

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

Object literals​

Objects in Textwire are very similar to JavaScript object with key-value pairs. Here is an example of defining an object:

{{ person = {"name": "John", "age": 25} }}

You can also use key names without quotes if your keys are valid identifiers:

{{ person = { name: "John", age: 25 } }}

You can access values in an object by using a key. Here is an example of accessing values in an object:

{{ user = {age: 25, name: {first: "Anna", last: "Cho"}} }}

<ul>
    <li>First name: {{ user.name.first }}</li> <!-- "Anna" -->
    <li>Last name: {{ user.name.last }}</li> <!-- "Cho" -->
    <li>Age: {{ user.age }}</li> <!-- 25 -->
</ul>
Case insensitive fields

Object fields are case insensitive. It means that you can access fields in an object by using any case. For example, {{ user.name.first }} and {{ user.Name.First }} will return the same value. It's done this way for convenience.

Shorthand property notation​

Similar to objects in JavaScript, you can use shorthand property notation to define an object. Here is an example of using shorthand property notation:

{{ name = "John"; age = 25; person = { name, age } }}