Skip to content

Latest commit

 

History

History
152 lines (123 loc) · 4.09 KB

bicep.md

File metadata and controls

152 lines (123 loc) · 4.09 KB
Raw

Bicep Language Specification

Structure

An individual .bicep file is composed of the following declarations, in any order. Each declaration must be separated from the next by at minimum a single new line.

Whitespace

Spaces and tabs are ignored when authoring Bicep files. New lines however have semantic meaning, for example in object and array declarations.

Comments

Single line

Single line comments begin with //.

Examples

var myVar = 'hi!' // this is a comment

Multi line

Multi-line comments are declared between /* and */ characters.

Examples

/* this 
is a 
multi line comment */

var myVar = 'hi!' /* so is
this */

Literals

The sections below cover common types of literals you will encounter in Bicep. See Bicep Data Types for additional information about the type system and validation rules.

Strings

Strings are defined by a sequence of characters between single quote (') characters, and must be declared on a single line.

The following are the set of reserved characters which must be escaped by a backslash (\) character:

Escape Sequence Represented value Notes
\\ \
\' '
\n line feed (LF)
\r carriage return (CR)
\t tab character
\$ $ Only needs to be escaped if it is followed by {

All strings in Bicep support interpolation, in order to reference expressions in-place. To inject an expression, surround it by ${ and }. Expressions that are referenced cannot span multiple lines.

Examples

// myVar evaluates to "hello!"
var myVar = 'hello!'

// myVar evaluates to "what's up?"
var myVar2 = 'what\'s up?'

// myVar evaluates to "hello steve!"
var name = 'steve'
var myVar3 = 'hello ${name}!'

Numbers

Number literals are formatted as integers - a list of digits optionally preceeded by a -. Floating point, decimal or binary formats are not currently supported.

Examples

var myVar = 123
var myVar2 = -454
var mvVar3 = 0

Booleans

Boolean literals consist of the keywords true and false

Examples

var myVar = false
var myVar2 = true

Arrays

Arrays are declared using the open and close square bracket characters ([ and ]), and consist of a set of values. Each value pair must be on a new line, and there must be a new line after the opening bracket and before the closing bracket. The values may consist of either a literal or an expression.

Note that commas are not required or permitted between array values.

Examples

var myArray = [
  5983
  3923
  -241
]

var myEmptyArray = [
]

var myMixedArray = [
  myVariable
  'hello!'
  true
  1255
]

Objects

Objects are declared using the open and close brace characters ({ and }), and consist of a set of keys and values. Each key/value pair must be on a new line, and there must be a new line after the opening brace and before the closing brace. Keys and values are separated with the colon (:) character.

Keys must either be a sequence of alphanumeric characters, or a string in cases where special characters or in-line expression interpolation is needed. Values may consist of any literal or an expression.

Note that commas are not required or permitted between object property pairs.

Examples

var myObj = {
  stringProp: 'hello!'
  boolProp: false
  numberProp: -464
  objProp: {
    nestedString: 'hello nested!'
  }
  arrayProp: [
    1234
    3435
  ]
  variableProp: myVariable
}

var myObjWithSpecialChars = {
  '$special\tchars!': true
  normalKey: 'val'
}

var name = 'Steve'
var objWithInterpolatedKeys = {
  'Hello ${name}!': 'val'
  '${name}': 'val'
  '${name == 'Steve' ? 'wibble' : 'wobble'}': 'val'
  '${guid(name)}': 'val'
}

var myEmptyObj = {}

Null

Null may be declared using the keyword null

Examples

var myVar = null