FLoWS 101

FLoWS is a functional language with full access to WarpLib.

FLoWS is an alternative to WarpScript for users discovering the Warp 10 Platform. It is meant to be easy to learn, look familiar to users of other programming languages and enable time series analysis by leveraging the whole of WarpLib.

FLoWS is entirely compatible with WarpScript, the two languages can even be mixed within the same program.

Once familiar with WarpLib via the use of FLoWS, users can choose to dive into WarpScript to gain improved performance.

FLoWS comes as a WarpScript extension and is available on WarpFleet.

The rest of this page will guide you through the whole syntax of FLoWS.

Comments

FloWS supports C and C++ style comments.

// C++ Style comments
/*
C-Style comments
*/

Supported types

FLoWS supports LONGs and DOUBLEs.

42        // LONG
0x2a      // LONG
3.14      // DOUBLE
1.0E-12   // DOUBLE

BOOLEANs are supported

true  // Not False
false // Not True

Percent encoded STRINGs using UTF-8 are enclosed in single or double quotes.

'Hello'
"%F0%9F%96%96"	// 🖖
'Multiline
Strings'

Lists are comma separated expressions enclosed in square brackets.

[ 'Hello', 3.1415, 42 ]
[ 'Hello', 3.1415,
  42	// Works on multiple lines too
]

Maps are comma separated key:value pairs enclosed in curly braces.

{ 'A':65, '@':64, 64:'@' }
{ '@':64, 64:'@',
  'A':65  // Works on multiple lines too
}

Accessing list and map elements is done using an intuitive syntax.

map['A']  // 65
map[64]   // '@'
list[0]   // 'Hello'

Operators

Simple left to right precedence with optional parentheses grouping.

Binary operators: +, +!, |, -, **, *, /, %.

Comparison and logical operators: >, <, <=, >=, ==, !=, ~=, &&, ||

Bitwise operators: &, |, ^, >>>, >>, <<

A = 5 + 3 / 2.0
X = 8 + (F(x + 1) * 3.14) - 12

Function calls

Comma separated list of expressions as function parameters. Functions can return 0 to N values.

F(1,2,'A',b)  // F is the function name
G()           // Parameterless function call

Assignments

Assignments assign values to variables

A = 12
(x, y) = F(1)   // F MUST return two values
M[0][1] = 3.14  // Assign to list/map element

Macros

Macros are sequences of statements.

M = (a,b,c) -> {  // 3 parameters
  ...
}

Macros can return 0 to N values just like functions, use return as last statement followed by a comma separated list of values to return.

M = (a,b,c) -> {  // 3 parameters
  return F(a,b), G(c)
}

Expected number of return values can be enforced.

M = (a,b,c) -> 2 {  // MUST return 2 values
  return F(a,b), G(c)
}

Macros are called like functions, with a comma separated list of expressions as parameters. Macro name is prefixed with @ like in WarpScript.

@M(1,2,3)
(x,y) = @M(1,2,3)  // Assign return values

When using variables in macros you can either use the name of the variable, e.g. A, the variable will be replaced by its value at the time of the execution, or use the name suffixed with ! to use the value of the variable at the time of the macro definition.

Tutorials

Now you've read this page, you can start learning FLoWS with the tutorials here.