Transformers
Transformers are projection-type functions that are bundled with Slice and translate types between each other.
Generic Transformers
There are built-in pure functions that operate on any contract type and map the values. They are the basic building blocks of data manipulation. They can be user-defined and are injected at build-time
Examples
add($value1, $value2)find(#listValue, 'id', 4)mult(avg(#listValue), $count)
Context Transformers
They translate Contexts between each other and are used inside Reducers to update internal data of the FSM when changing States. They are defined as a part of State Dictionary and can be injected at compile time.
Examples
#{stepIndex} <= nextStep(#stepIndex)#{email, password, input_error} <= sanitize(#email), sanitize(#password), validate(#email, #password)}
Reducer Transformers
Function that translate from State+Action/Payload to State/Context can be injected into FSMs at compile time.
#{propertyA, propertyB} = reducerA(#propertyA, $payloadA, reducerB(#propertyB, $payloadB)
Model Transformers
Model transformers are a subtype of Effects that are context-free and are basically functions that mutates the Data Model.
#{counter} <= add(№counter, increaseGlobalCounter($value))
They can be composed with Predicates to create conditional mutations, but this approach is not recommended, since it splits the responsibility of Effects.
Built-Ins: Arithmetics
| Function(s) | Argument Type | Argument Value | Return Type | Return Value |
|---|---|---|---|---|
add | Number, [Number...] | any numbers | Number | sum of arguments |
diff | Number, Number | two numbers | Number | the second number reduced by the first number |
mult | Number, [Number...] | any numbers | Number | product arguments |
div | Number, Number | two numbers | Number | the first number divided by the second number |
pow | Number, Number | base and power | Number | exponentiation of two numbers |
inc | Number | a single number | Number | shortcut for add(number,1) |
dec | Number | a single number | Number | shortcut for add(number,-1) |
neg | Number | a single number | Number | shortcut for mult(number,-1) |
inv | Number | a single number | Number | shortcut for div(1,number) |
mod | Number, Number | two numbers | Number | first number modulo the second one |
trunc | Number | a single number | Number | a nearest integer less than the argument |
ceil | Number | a single number | Number | a nearest integer greater than the argument |
round | Number | a single number | Number | mathematically rounded argument |
Built-Ins: Special Maths
| Function(s) | Argument Type | Argument Value | Return Type | Return Value |
|---|---|---|---|---|
sin | Number | a single number | Number | sine of the argument |
cos | Number | a single number | Number | cosine of the argument |
sqrt | Number | a single number | Number | square root of the argument |
log | Number, Number | number and base | Number | logarithm of the number to the base |
ln | Number | number | Number | logarithm of the number to the e base |
lg | Number | number | Number | logarithm of the number to the 10 base |
deg | Number | number | Number | converts degrees to radians |
rad | Number | number | Number | converts radians to degs |
Built-Ins: Statistics
| Function(s) | Argument Type | Argument Value | Return Type | Return Value |
|---|---|---|---|---|
max | Number, [Number...] | any numbers | Number | maximum of passed values |
max | List | list of numbers | Number | maximum of passed list |
min | Number, [Number...] | any numbers | Number | minimum of passed values |
min | List | list of numbers | Number | minimum of passed list |
avg | Number, [Number...] | any numbers | Number | average of passed values |
avg | List | list of numbers | Number | average of passed list |
med | Number, [Number...] | any numbers | Number | median of passed values |
med | List | list of numbers | Number | median of passed list |
sum | List | list of numbers | Number | sum of passed list |
sumsq | List | list of numbers | Number | sum of passed list |
sumProduct | List, [List...] | Any amount of Lists, each being a list of numbers | any | sum of the products of corresponding values in two or more supplied arrays |
Built-Ins: List Transformers
| Function(s) | Argument Type | Argument Value | Return Type | Return Value |
|---|---|---|---|---|
len | List | - List | Number | quantity of items in the List |
lookup | List, any | - List - search element | any | the second argument, if it's present in the List, Null otherwise |
filterBy | List, String, any | - List of objects - property name - seek value | List | returns new List with objects from the passed the List, which have the named property equal to passed seek value |
find | List, String, any | - List of objects - property name - seek value | List | returns new the first object from the passed the List, which have the named property equal to passed seek value, Null if none found |
left | List, Number | - List - Length | String | first N items in the List |
right | List, Number | - List - Length | String | last N items in the List |
indexOf | List, any | - List - List | any | the index of search element, if it's present in the List, -1 otherwise |
Built-Ins: String Transformers
| Function(s) | Argument Type | Argument Value | Return Type | Return Value |
|---|---|---|---|---|
substr | String, Number [, Number] | - String - Start position - End position | String | a substring of given String, see JS String.Substring |
len | String | - List | Mumber | quantity of symbols in the string |
left | String, Number | - String - Length | String | first N symbols of the string |
right | String, Number | - String - Length | String | last N symbols of the string |
indexOf | String, String | - String - search substring | any | the index of search substring, if it's present in the first string, -1 otherwise |