Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To use SIL like any other scripting language follow a few simple syntax rules.

General rules

  • All instructions end with a semicolon ;

...

Code Block
titleExample
// single line comment
/*
this comment
spans over
multiple lines
*/ 


Types

Basic Types

SIL defines the following base types:

  • string - defines a string, example literal is "abc"
  • boolean - defines boolean values true and false
  • number - any numeric (integer or real) value
  • date - a date, like "2010-03-30"
  • interval - a time interval, like "2d 3h"

Important notes

  • interval - data type does not represent the working interval (i.e. 8h), but the full interval. When we created SIL™ we thought about if we should introduce a working interval type (i.e. 8h / day) but this would have certain undesired implications (how long is your workday? in France, for instance, Friday is only 6h). With our custom fields, it's a matter of interpretation of the interval, and we have routines to help you transform a 24h interval to a working interval, or you can simply write your own.
  • date - data type can be used to represent dates and date-times.
  • number - data type internal storage is represented only by real numbers (double). However, the language accepts for historical reasons type declarations as "integer", "int", "real", "double", "float" (treating them as "number", of course). Until now we have found no limitations regarding the uniform treatment of numbers.

Arrays

Multi-value (arrays) types are also supported and composed of the base type followed by the array symbols [ ]  for each dimension of the array type. This translates to the following being valid array types:

  • string[]
  • boolean[]
  • number[][]
  • date[][][]
  • interval[]
  • Person[][] - where Person is a user-defined structure


Key-Value Arrays (Maps)

Arrays are actually maps where values are keyed by their position in the list, and so key-value arrays are declared the same as regular arrays.

Learn more about maps and the indexing operator.

Structures

The general syntax for defining a structure is:

...

Code Block
titleExample
// considering structure Person defined above
Person p; 
p.name = "John Doe";
p.id = "1234567";
string hisManager = p.manager.name;
string employee = p.subordinates[0].name;


Constants

Info

This topic is about constant values, NOT about the read-only attribute of variables.


Single Value Constants

For numbers and boolean values, constants are represented without any additional alterations.

...

Code Block
titleExample
// valid dates
"2010-12-31"
"2010-12-31T24:59:59" (the default configured timezone is taken)
"2010-12-31T24:59:59Z" (Zulu time = UTC = GMT)
"2010-12-31T22:59:59+0200" (UTC+2)
"2010-12-31T24:59:59.999Z" (Zulu time = UTC = GMT)
"2010-12-31T22:59:59.999+0200" (UTC+2)

// interval
"1w 2d 3h 4m"

Array Constants

Arrays are created using the following syntax:

...

Note
titleNote

We currently do not support constant representation of key-value arrays. You will need to build one using the indexing operator.


Variable Declaration

The general syntax for declaring a variable is: 

...

Code Block
titleExample
string name = "John Doe";
number random = 2;
number pi = 3.14;
boolean valid;
date today = currentDate();
interval spent = "1h 30m";
interval estimate = "2d" - spent;
number [][] matrix = {{0,1}, {2,3}, {4,5}};

Constant variables

Variables can be made read-only by adding the keyword "const" before the type when the variable is first defined.

...

If set to an array or structure, the read-only attribute will be applied to all the elements of the array or fields of the structure.


Routine Declaration

In addition to the routines provided out-of-the-box by SIL, you can define your local routines (user-defined routines or UDRs in short) that use the following syntax:

Code Block
function <name>(<type> param1, <type> param2, ...) {
   Instruction1;
   ...
   InstructionN;
   return <value>;
}

Learn more about UDRs.

Explicit Type Casts

Most of the time, SIL™ will attempt to do the type-casting for you automatically, however this cannot be always performed like this. These type casts allow you explicitly to convert a variable to a specific type.The general syntax for casting is:

...

Note
titleNote

Not all type casts are valid. For example it makes no sense to convert an interval to a date.

See also