Functions
Functions can be applied on values. Functions take a tuple as argument (param1, param2) which can be built from aforementioned primitives.
Boolean
| Function | Description | Usage | Result |
|---|
| | | or operation. | true | false | true |
| & | and operation. | false & true | false |
| tostring | convert boolean to a string. | tostring(true) | "true" |
String
| Function | Description | Usage | Result |
|---|
| + | concatenate two strings | "Hello" + "world" | "Hello world" |
| trim | remove leading and trailing spaces | trim(" Hello world ") | "Hello world" |
| upper | convert string to upper case | upper("Hello world") | "HELLO WORLD" |
| lower | convert string to lower case | lower("Hello WORLD") | "hello world" |
| version | get unique hash for project identifier. | version("/src/apps/webapp") | 159E0....E786 |
| replace | replace in string. | replace("Hello world", "world", "Terrabuild") | Hello Terrabuild |
| format | format a string using variable args. | format("{1} {0}!", "Terrabuild", "Hello") | Hello Terrabuild! |
| format | format a string using a map argument. | format("Hello {name}!", {name: "Terrabuild" }) | Hello Terrabuild! |
Number
| Function | Description | Usage | Result |
|---|
| + | add two numbers | 5 + 2 | 7 |
| - | substract two numbers | 5 - 2 | 3 |
| tostring | convert number to string | tostring(42) | "42" |
List
| Function | Description | Usage | Result |
|---|
| Item | Get item at position: error if index is not valid | [1 2 3].1 | 2 |
| TryItem | Try get item at position: nothing if index is not valid | [1 2 3].?4 | nothing |
| Count | Get number of element of list | count([1 2 3]) | 3 |
| + | Concatenate two lists | [1 2 3] + [4 5 6] | [1 2 3 4 5 6] |
Map
| Function | Description | Usage | Result |
|---|
| Item | Get named item (using identifier): error if index is not valid | { a: 1 b: 2 }.b | 2 |
| TryItem | Try get named item (using identifier): nothing if index is not valid | { a: 1 b: 2 }.?c | nothing |
| Count | Get number of element of map | count({ a: 1 b: 2 }) | 2 |
| + | Merge two maps | { a: 1 b: 1} + { b: 2 c: 2} | { a: 1 b: 2 c: 2} |
Generic
| Function | Description | Usage | Result |
|---|
| Not | true if falsy (nothing or false) | !false | true |
| Equal | compares two values for equality | "env" = "prod" | false |
| NotEqual | compares two values for inequality | "env" != "prod" | true |
| Null-Coalesce | return value or alternate value if nothing | nothing ?? 42 | 42 |
| Ternary Conditional | checks boolean value and returns truthy or falsy value | nothing ? 42 : 666 | 666 |