Operators

Looking for the documentation on the newest versions of SIL Engine and the Simple Issue Language for Jira 8 for Server/Data Center? Click here !

Contents

 

Arithmetic, Logical and Comparison Operators

Here is a list of the available operators in a SIL™ program and detailed usage information.

Arithmetic operators

In version 2.5 (and 3.0 yet again) we have reworked the way operators handle different types and conversions by putting an emphasis on the left-hand side (LHS) value of the operation. Consequently, only the right-hand side (RHS) operand will be converted (if necessary) to a type that is valid for the current operation with the LHS type.

For each operator and LHS type, we define two lists: valid types and convertible types. The list of convertible types is based on Type conversion. This creates three cases:

  1. If the RHS type is one of the valid types, then the operation will proceed as it is and the result calculated according to the table below.
  2. If the RHS type is one of the convertible types, then it will attempt to convert it to one of the valid types (in the order the valid types are presented in the table below) until the conversion succeeds and then proceeds according to case 1.
  3. If the RHS type is neither valid nor convertible, the program will end in error.

Operator

LHS type

Valid Types

Result

Explanations and Usage

+

number

numbernumber

standard addition of numbers

stringstringstringadds the string representation of the RHS operand at the end of the LHS string
booleanUnsupported
dateintervaldateadds the interval to the date and returns the result
intervalintervalintervaladds the two intervals and returns the result
datedateadds the interval to the date and returns the result
<type> []<type><type> []adds the RHS value to the LHS array, where <type> can be any type.

-

number

number

number

standard subtraction of numbers

stringstringstringremoves all occurrences of the RHS string in the LHS value
booleanUnsupported
datedateintervalreturns the interval difference between the two dates
intervaldatesubtracts the RHS interval from the date and returns the value
intervalintervalintervalstandard interval subtraction
<type>[]<type><type>[]removes the first occurrence of the RHS value from the array; <type> can be any type.
*numbernumbernumberstandard multiplication of numbers
intervalintervalmultiplies the interval by the number of times specified by the LHS operand and returns the result
number [] numbernumber []

multiplies each value in the LHS array with the number in the RHS operand and returns the result

stringUnsupported
booleanUnsupported
dateUnsupported
intervalnumberintervalmultiplies the interval by the number of times specified by the RHS operand and returns the result

<type>[]

(except number)

Unsupported
/




number

numbernumberstandard division of numbers
number []numbernumber []divides each value in the LHS array by the number in the RHS operand and returns the result
stringUnsupported
booleanUnsupported
dateUnsupported
intervalnumberintervaldivides the interval by the number specified in the RHS operand

<type>[]

(except number)

Unsupported
%numbernumbernumberstandard modulo division of numbers
number []numbernumber []applies the modulo operator on each number in the LHS array with the number in the RHS operand and returns the results
stringUnsupported
booleanUnsupported
dateUnsupported
intervalUnsupported

<type>[]

(except number)

Unsupported

You can also use the combined forms of the arithmetic operators with the attrib operator: +=, -=, *= and /=.

string s = "a";
s = s + "b";
// is equivalent with
s += "b"; 

Numbers also support the pre/post increment/decrement operators.

--i; 
i--;
++i;
i++;

Comparison operators

Operator

Operands

Return

Explanations and Usage

== (alias 'eq')

Right operand will be casted to the left operand's type if their types are different

true/false

Returns true if the values are equal and false otherwise.

!= (alias 'neq')

Right operand will be casted to the left operand's type if their types are different

true/false

Returns false if the values are equal and true otherwise.

< (alias 'lt')

Right operand will be casted to the left operand's type if their types are different

true/false

Returns true if the first value is lower than the second one and false otherwise.

> (alias 'gt')

Right operand will be casted to the left operand's type if their types are different

true/false

Returns true if the first value is greater than the second one and false otherwise.

<= (alias 'le')

Right operand will be casted to the left operand's type if their types are different

true/false

Returns true if the first value is lower then or equal to the second one and false otherwise.

>= (alias 'gt')

Right operand will be casted to the left operand's type if their types are different

true/false

Returns true if the first value is greater than or equal to the second one and false otherwise.

Logical operators

Operator

Operands

Return

Explanations and Usage

&& (alias 'and')

boolean && boolean

true/false

Logical "and"

|| (alias 'or')

boolean || boolean

true/false

Logical "or"

! (alias 'not')

boolean

true/false

Logically complements of the specified boolean.

! (alias 'not')

number

number

Complements the number in relation to 0. (returns number * -1)

Ternary operators

Operator

Operands

Return

Explanations and Usage

?:boolean, <type>, <type><type>
<condition> ? <ifTrueValue> : <ifFalseValue>

If <condition> is true, returns <ifTrueValue>, otherwise returns <ifFalseValue>.

Note that <ifTrueValue> and <ifFalseValue> must have same type.


The Indexing Operator

The basic use of the indexing operator (introduced in version 2.5) is to allow you to easily access the contents of a list.

General syntax
string [] arr = {"a", "b", "c"};
string contents = arr[0] + arr[1] + arr[2] + arr[3]; // as user friendly as arrayGetElement, if index is out of bounds, will return an empty value.
arr[3] = "d";

Moreover, it allows you to create key-value lists (maps) and retrieve values from them by using a string inside the operator (instead of a number).

number [] map;
map["one"] = 1;
map["two"] = 2;
print(map["one"]);
// note that when used in a for-loop, map only has 2 elements: 1 and 2. The keys will be hidden.
print(map); // will print 1|2

When accessing a map as a list, the contents are retrieved in the order they were added. You can still use the operator with an integer value even on maps.

date [] days;
days["yesterday"] = currentDate() - "1d";  // added as first element
days["today"] = currentDate();		   // added as second element
days["tomorrow"] = currentDate() + "1d";   // added as third element
if(days["today"] == days[1]){
	print("Today is the second element in the array"); // yes, this will be printed
}

The indexing operator can also be used with certain simple types (not arrays) and a specific value to provide additional functionality.

SIL™ typeIndex ValueGetGet Return TypeSet
stringa numberGets the character at the specified index in the stringstringInserts a character at the specified index. If given a longer string, it will insert the first character of the string.
date"DAY"Gets the day of month from the datenumberUnsupported
"MONTH"Gets the month from the datenumberUnsupported
"YEAR"Gets the year from the datenumberUnsupported
"HOUR"Gets the hour (0-23) from the datenumberUnsupported
"MINUTE"Gets the minute (0-59) from the datenumberUnsupported
"SECOND"Gets the seconds (0-59) from the datenumberUnsupported
"MILLISECOND"Gets the milliseconds (0-999) from the datenumberUnsupported
"WEEK"Gets the week number within the current yearnumberUnsupported
"WEEKINMONTH"Gets the week number within the current monthnumberUnsupported
"TOMILLIS"Gets the current time as UTC milliseconds from the epoch.numberUnsupported
"DAYOFWEEK"Gets the three letter format for the day of the week (e.g. "Mon", "Tue", "Wed" etc)stringUnsupported
"MONTHNAME"Gets the three letter format for the name of the month (e.g. "Jan", "Feb", "Mar", etc.)stringUnsupported
interval"WEEK"Gets the number of whole weeks inside the interval (e.g. interval i = "1w 14d"; i["WEEK"] will return 3)numberUnsupported
"DAY"Gets the number of whole days inside the interval (e.g. interval i = "1d 48h"; i["DAY"] will return 3)numberUnsupported
"HOUR"

Gets the number of whole hours inside the interval (e.g. interval i = "1h 120m"; i["HOUR"] will return 3)

numberUnsupported
"MINUTE"Gets the number of whole miuntes inside the interval (e.g. interval i = "1m 120s"; i["MINUTE"] will return 3)numberUnsupported
"SECOND"Gets the number of seconds inside the interval (e.g. interval i = "1h 1m 3s"; i["SECOND"] will return 3)numberUnsupported
"TOMILLIS"Gets the number of milliseconds inside the intervalnumberUnsupported


See also