[CS2] Template Operators

Operators are symbols that allow you to compare two values or combine two values.

Comparison Operators

Many times you whether in using a ternary condition or in conditional rendering you'll want to use a comparison operator. This page documents what is available to you in the component studio templating language. These operators will return true or false.

Operator Description Example
== Equal to. Note that = is not the same thing. {{quantity == 5}}
{{color == 'blue'}}
!= Not equal to. {{quantity != 5} }
{{color != 'blue'}}
> Greater than. {{quantity > 2}}
< Less than. {{quantity < 2}}
>= Greater than or equal to. {{quantity >= 2}}
<= Less than or equal to. {{quantity <= 2}}
if else Ternary condition. It takes 3 arguments. The first is the true value condition to validate, and then the false value. {{true if level > 2 else false}}

Arithmetic Operators

Perform a mathematical calculation upon two values.

Operator Description Example Result
+ Addition {{1 + 1}} 2
- Subtraction {{1 - 1}} 0
* Multiplication {{1 * 1}} 1
/ Division {{1 / 1}}
{{5 / 2}}
1
2.5
// Division with truncation. {{1 // 1}}
{{5 // 2}}
1
2
% Modulus, the remainder after division. {{1 % 1}}
{{5 % 3}}
1
2
** The power of another number. {{2**2}} 4

Logical Operators

Perform logic operations on values to determine a true or false value.

Operator Description Example Result
not Not. Inverts the value. {{not 1}} 
{{not 3 < 1}}
false 
true
and And. {{0 and 0}}
{{1 and 0}}
{{1 and 1}}
{{ 3 > 1 and 1 > 0}}
false
false
true
true
or Or. {{0 or 0}}
{{1 or 0}}
{{1 or 1}}
{{ 3 > 1 or 1 > 0}}
false
true
true
if else   



Ternary. It takes 3 arguments. The first is the true value then the condition to validate, and then the false value. Note that the false value is optional. {{ 'purple' if position == 'king' else 'white'}}
{{ 'purple' if position == 'king'}}
purple
purple

String Operators

Use the to manipulate strings.

Operator Description Example Result
+ Concatenate. Combines two strings together. {{'R' + 'G' + 'B'}}
{{first_name + ' ' +  last_name}}
RGB
Andy Dufresne

Empty

When you are trying to check for a field that is empty, then you'll want to use 2 half quotes ''.

{{this_might_be_empty == ''}}

Another way to do this would be to simply put the variable in the field, as Component.Studio treats empty fields as false. So if you were to put this in the "render this layer?" field, it would work:

{{ this_might_be_empty }}

This last option will likely never come up, but it is possible that some values will be defined as 'null'. In those very rare circumstances, you can test for that by using the special keyword null without quotes like this:

this_is_null == null
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us