В блоке операций/выражений можно указывать произвольное количество операций которые должен вычислить бот в процессе своей работы. Операции представляют собой выражения записанные с помощью подмножества языка программирования разговорных ботов описание которого содержится ниже.

Структура операций

Все операции бота в пределах одного блока операций представляют собой одно или несколько выражений на языке прграммирования ботов. Выражения отделяются друг от друга необязательным символом ";", либо символом перевода строки (началом новой строки). Каждое выражение имеет значение. Это значит что выражения могут быть составными.

Комментарии

При записи выражений можно указывать комментарии - участки программы которые не участвуют в вычислениях, а выполняют лишь информационную функцию. Есть два вида комментариев:

...

// Это однострочный комментарий
$x = time()

/**
 * А это уже
 * многострочный
 * комментарий
 */
say("Time is " + $x)

Переменные

Для хранения данных в сценариях ботов применяются переменные. Переменная представляет собой именованный участок памяти бота. Она создаётся при первом её использовании в каком-либо блоке операций. При этом значением по умолчанию для всех переменных является nil.

...

$('日本') = 123         // Создали переменную c именем 日本
$x = $('日本')          // $x теперь равна 123
$(math.rand(1, 2)) = 0 // Динамически создаём переменную с именем 1 или 2 и присваеваем ей значение 0

Переменные переменных

Язык выражений бота позоляет динамически вычислять имя переменной в процессе работы бота. Это в частности означает что значением одной переменной может быть имя другой переменной. Или, в более общем случае, именем переменной может быть любое выражение, значением которого является строка.

...

// $x содержит название переменной #y
$x = "y"

// #y содержит название глобальной переменной communicationType
#y = "communicationType"

// Вычисляется так @#$x -> @#("y") -> @#y -> @("communicationType") -> @communicationType
$communicationType = @#$x

Типы данных

Существует три примитивных типа данных один объектный тип и специальное значение nil:

Числа

Все числа трактуются как вещественные знаковые с плавающей точкой. Минимальное и максимальное значение определяется той вычислительной средой в которой работает интерпретатор языка выражений.

Строки

Представляют собой произвольную последовательность симолов заключённую в одинарные или двойные кавычки. Двойные кавычки отличаются от одинарных тем что внутри них распознаются следующие специальные последовательности символов:

...

// Следуюущая команда выведет в чат фразу из двух строк
// Привет
// "Медвед!"
say("Привет\n\"Медвед!\"")

// Выведет в чат фразу Привет\n'Медвед!'
say('Привет\n\'Медвед!\'')

Булевые (логические) значения

Константы true и false трактуются как булевые, т.е. такие значения у которых есть только два состояния - истина и ложь. Булевые значения удобно применять в выражении условного блока.

$x = true  // $x содержит ИСТИНА
$y = !$x   // $y содержит ЛОЖЬ

Объекты

В стандартной библиотеке языка программирования бота существует ряд функций (операций) значением которых являются так называемые объекты. Объект это особое значение у которого могут быть встроенные свойства и операции или методы. Набор этих свойств и методов определяется типом объекта. Для доступа к свойствам или методам объектов используется оператор точка "."

...

Существует три типа встроенных объектов являющихся коллекциями произвольных элементов

Кортежи

Кортеж или tuple это неизменяемая упорядоченная коллекция произвольных элементов. Создать кортеж можно с помощью круглых скобок:

...

count()

(1, 2, 3).count()

first()

(1, 2, 3).first()

last()

(1, 2, 3).last()

has(index)

(1, 2, 3).has(0)
(1, 2, 3).has(3)

get(index)

(1, 2, 3).get(1)
(1, 2, 3).get(3)

(1, 2, 3).get(3)
(1, 2, 3).get(0)

(1, 2, 3).index(3)
(1, 2, 3).index(0)

equals(other)

('a', 'b').equals(('a', 'b'))
('a', 'b').equals(('b', 'a'))

hash()

('a', true).hash()

Списки

Список или list это изменяемая упорядоченная коллекция произвольных элементов. Создать список можно с помощью квадратных скобок:

...

count()

[1, 2, 3].count()

first()

[1, 2, 3].first()

last()

[1, 2, 3].last()

has(index)

[1, 2, 3].has(0)
[1, 2, 3].has(3)

get(index)

[1, 2, 3].get(1)
[1, 2, 3].get(3)

[1, 2, 3].contains(1)
[1, 2, 3].contains(0)

[1, 2, 3].index(1)
[1, 2, 3].index(0)

toTuple()

[1, 2, 3].toTuple()

clear()

$x = [1, 2, 3]
$x.clear()

reverse()

[1, 2, 3].reverse()

append(item)

[1, 2, 3].append(4)

prepend(item)

[1, 2, 3].prepend(0)

shift()

$x = [1, 2, 3]
$y = $x.shift()

pop()

$x = [1, 2, 3]
$y = $x.pop()

set(index, item)

$x = [1, 2, 3]
$y = $x.set(1, 0)
$z = $x.set(5, 'a')

remove(index)

$x = [1, 2, 3]
$y = $x.remove(1)

equals(other)

['a', 'b'].equals(['a', 'b'])
['a', 'b'].equals(['b', 'a'])

hash()

['a', true].hash()

Ассоциативные массивы (словари)

Ассоциативный массив или словарь (map) это изменяемая упорядоченная поллекция произвольных пар ключ/значение. Создаётся словарь с помощью фигурных скобок:

...

count()

{1: 'a', 2: 'b', 3: 'c'}.count()

clear()

$x = {true: false, 'b': true}
$x.clear()

reverse()

{'a': 1, 'b': 2, 'c': 3}.reverse()

values()

{'a': 1, 'b': 2, 'c': 3}.values()

keys()

{'a': 1, 'b': 2, 'c': 3}.keys()

firstKey()

{'a': 1, 'b': 2, 'c': 3}.firstKey()

lastKey()

{'a': 1, 'b': 2, 'c': 3}.lastKey()

first()

{'a': 1, 'b': 2, 'c': 3}.first()

last()

{'a': 1, 'b': 2, 'c': 3}.last()

contains(item)

{'a': 1, 'b': 2, 'c': 3}.contains(2)
{'a': 1, 'b': 2, 'c': 3].contains(4)

has(key)

{'a': 1, 'b': 2, 'c': 3}.has('a')
{'a': 1, 'b': 2, 'c': 3].has('d')

get(key)

{'a': 1, 'b': 2, 'c': 3}.get('b')
{'a': 1, 'b': 2, 'c': 3}.get('d')

$x = {1: true, 2: nil}
$x.set(2, false)

equals(other)

{'a': 'b'}.equals(['a': 'b'])
{'a': 'b'}.equals(['b': 'a'])

hash()

{'a': true}.hash()

Специальное значение nil

Когда какая-либо переменная не определена, но уже используется в выражении её значением становится nil. Это специльное значение означающее отсутствие какого-либо значения. Это значение также можно присвоить явно:

$x = 1 + 2 // $x содержит 3
$x = nil   // $x содержит nil

Операции

В языке выражений бота определенно несколько классов операций. Класс операции определяется её первым аргументом. Например, если первый аргумент операции "+" строка, то будет произведена конкатенация строк. Если же это число, то будет осуществляться сложение чисел.

Приоритеты операций

Чем приоритет выше, тем раньше выполнится операция. Стандартным способом увеличения приоритета являются круглые скобки.

Арифметические операции

Арифметические операции предназначены для работы с числами. Если значение участвующее в арифметической операции не является числом, произойдёт попытка его преобразования в число (см. ниже).

+$a

-$a

$a + $b

$a - $b

$a * $b

$a / $b

$a \ $b

$a % $b

$a ** $b

Побитовые операции

Это отдельный класс операций предназначенных для выполнения над битовыми представлениями целых чисел.

...

Логические операции

Логические операции предназначены для работы с булевыми значениями. Если значение не является булевым, то произойдёт попытка его преобразования в булевое значение (см. ниже).

...

Операции со строками

Есть только одна операция для работы со строками. Это сложение или конкатенация строк:

...

Операции сравнения

Операции сравнения выполняются над любыми типами данных и результатом их вычисления являются булевые значения.

$a == $b

$a != $b

$a > $b

$a >= $b

$a < $b

$a <= $b

Операции с коллекциями

Для встроенных типов объектов tuple, list и map доступна одна операция объединения:

(1, 2) + (3, 4)

['a', 'b'] + ['c']

{'a': 0, 'b': 2} + {'a': 1, 'c': 3}

Операции присваивания

Операции присваивания повзоляют назначать переменным какое-либо значение:

...

($x, $y, $z) = (1, 2, 3)

$x = 1
$y = 2
$z = 3

(1, 2, 3)

[$x, $y] = ($y, $x)

$x = $y
$y = $x

[$y, $x]

{'a': $x, 'b': $y} = {'b': true, 'a': false}

$x = false
$y = true

{'a': false, 'b': true}

($x, $y, $z) += [1, 2, 3]

$x = $x + 1
$y = $y + 2
$z = $z + 3

($x + 1, $y + 1, $z + 1)

{3: $x, 7: $y} *= (2, 3)

$x = $x * 2
$y = $y * 3

{3: $x * 2, 7: $y * 3}

Функции

Основными строительными элементами выражений в блоке операций являются вызовы функций. Функция это некоторая часть функциональности бота. Например, с помощью функций можно оперировать датой и временем, вычислять более сложные арифметические операции, преобразовывать строку текста в намерения используя сервис NLU, работать с очередью сообщений клиента и т.д.

...