# Language: Expressions

This version of Puppet is not included in Puppet Enterprise. The latest version of PE includes Puppet 4.5. A newer version is available; see the version menu above for details.

**Expressions** resolve to values and can be used in **most** of the places where values of the standard data types are required. Expressions can be compounded with other expressions and the entire combined expression will resolve to a single value.

Most expressions resolve to boolean values. They are particularly useful as conditions in conditional statements.

## Location

Expressions can be used in the following places:

- The operand of another expression
- The condition of an if statement
- The control expression of a case statement
- The assignment of a variable
- The value of a resource attribute
- The argument(s) of a function call

They cannot be used in selectors or as resource titles.

## Syntax

An expression consists of two **operands** separated by an **operator;** the only operator that takes one operand is `!`

(not).

```
5 < 9
($operatingsystem != 'Solaris')
$kernel in ['linux', 'solaris']
!str2bool($is_virtual)
```

In the examples above, the operators are `<`

, `!=`

, `in`

, and `!`

.

Optionally, expressions can be surrounded by parentheses.

### Operands

Operands in an expression may be:

- Literal values
- Variables
- Other expressions
- Function calls which return values

The data type of each operand is dictated by the operator. See the list of operators below for details.

When creating compound expressions by using other expressions as operands, you should use parentheses for clarity:

```
(90 < 7) and ('Solaris' == 'Solaris') # resolves to false
(90 < 7) or ('solaris' in ['linux', 'solaris']) # resolves to true
```

## Order of Operations

Compound expressions are evaluated in a standard order of operations. However, parentheses will override the order of operations:

```
# This example will resolve to 30, rather than 23.
notice( (7+8)*2 )
```

For the sake of clarity, we recommend using parentheses in all but the simplest compound expressions.

The precedence of operators, from highest to lowest:

`!`

(not)`in`

`*`

and`/`

(multiplication and division)`-`

and`+`

(addition and subtraction)`<<`

and`>>`

(left shift and right shift)`==`

and`!=`

(equal and not equal)`>=`

,`<=`

,`>`

, and`<`

(greater or equal, less or equal, greater than, and less than)`and`

`or`

## Comparison Operators

Comparison operators have the following traits:

- They take operands of
**several data types** - They resolve to
**boolean**values

`==`

(equality)

Resolves to `true`

if the operands are equal. Accepts the following types of operands:

- Numbers — Tests simple equality.
- Strings — Case-insensitively tests whether two strings are identical.
- Arrays and hashes — Tests whether two arrays or hashes are identical.
- Booleans — Tests whether two booleans are the same value.

`!=`

(non-equality)

Resolves to `false`

if the operands are equal. Behaves similarly to `==`

.

`<`

(less than)

Resolves to `true`

if the left operand is smaller than the right operand. Accepts numbers.

The behavior of this operator when used with strings is undefined.

`>`

(greater than)

Resolves to `true`

if the left operand is bigger than the right operand. Accepts numbers.

The behavior of this operator when used with strings is undefined.

`<=`

(less than or equal to)

Resolves to `true`

if the left operand is smaller than or equal to the right operand. Accepts numbers.

The behavior of this operator when used with strings is undefined.

`>=`

(greater than or equal to)

Resolves to `true`

if the left operand is bigger than or equal to the right operand. Accepts numbers.

The behavior of this operator when used with strings is undefined.

`=~`

(regex match)

This operator is **non-transitive** with regard to data types: it accepts a string as the left operand and a regular expression as the right operand.

Resolves to `true`

if the left operand matches the regular expression.

`!~`

(regex non-match)

This operator is **non-transitive** with regard to data types: it accepts a string as the left operand and a regular expression as the right operand.

Resolves to `false`

if the left operand matches the regular expression.

`in`

Resolves to `true`

if the right operand contains the left operand. This operator is **case sensitive.**

This operator is **non-transitive** with regard to data types: it accepts a string as the left operand, and the following types of right operands:

- Strings — Tests whether the left operand is a substring of the right.
- Arrays — Tests whether one of the members of the array is identical to the left operand.
- Hashes — Tests whether the hash has a
**key**named after the left operand.

Examples:

```
'eat' in 'eaten' # resolves to TRUE
'Eat' in 'eaten' # resolves to FALSE
'eat' in ['eat', 'ate', 'eating'] # resolves to TRUE
'eat' in { 'eat' => 'present tense', 'ate' => 'past tense'} # resolves to TRUE
'eat' in { 'present' => 'eat', 'past' => 'ate' } # resolves to FALSE
```

## Boolean Operators

Boolean Operators have the following traits:

- They take
**boolean**operands; if another data type is given, it will be automatically converted to boolean - They resolve to
**boolean**values

These expressions are most useful when creating compound expressions.

`and`

Resolves to `true`

if both operands are true, otherwise resolves to `false`

.

`or`

Resolves to `true`

if either operand is true.

`!`

(not)

**Takes one operand:**

```
$my_value = true
notice ( !$my_value ) # Will resolve to false
```

Resolves to `true`

if the operand is false, and `false`

if the operand is true.

## Arithmetic Operators

Arithmetic Operators have the following traits:

`+`

(addition)

Resolves to the sum of the two operands.

`-`

(subtraction)

Resolves to the difference of the two operands.

`/`

(division)

Resolves to the quotient of the two operands.

`*`

(multiplication)

Resolves to the product of the two operands.

`%`

(modulo)

Resolves to the **remainder** of dividing the first operand by the second operand. (E.g. `5 % 2`

would resolve to `1`

.)

`<<`

(left shift)

Left bitwise shift: shifts the left operand by the number of places specified by the right operand. This is equivalent to rounding each operand down to the nearest integer and multiplying the left operand by 2 to the power of the right operand.

`>>`

(right shift)

Right bitwise shift: shifts the left operand by the number of places specified by the right operand. This is equivalent to rounding each operand down to the nearest integer and dividing the left operand by 2 to the power of the right operand.

## Backus Naur Form

With the exception of the `in`

operator, the available operators in Backus Naur Form are:

```
<exp> ::= <exp> <arithop> <exp>
| <exp> <boolop> <exp>
| <exp> <compop> <exp>
| <exp> <matchop> <regex>
| ! <exp>
| - <exp>
| "(" <exp> ")"
| <rightvalue>
<arithop> ::= "+" | "-" | "/" | "*" | "<<" | ">>"
<boolop> ::= "and" | "or"
<compop> ::= "==" | "!=" | ">" | ">=" | "<=" | "<"
<matchop> ::= "=~" | "!~"
<rightvalue> ::= <variable> | <function-call> | <literals>
<literals> ::= <float> | <integer> | <hex-integer> | <octal-integer> | <quoted-string>
<regex> ::= '/regex/'
```