...

...

На этой странице:

...

<a href="https://confluence.twin24.ai/pages/viewpage.action?pageId=137790002" target="_blank">Создание тестового виджета</a>.

В блоке операций/выражений можно указывать произвольное количество операций, которые должен

...

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

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

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

...

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

Комментарии

При записи выражений можно указывать комментарии

...

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

• Однострочные. Такие комментарии начинаются с

...

• символов // и заканчиваются окончанием строки.
• Многострочные. Начало многострочного

...

• комментария начинается с символов /* и заканчивается символами */.

Пример комментариев:

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

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

Переменные

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

...

своем использовании в каком-либо блоке

...

операция. При этом значением по умолчанию для всех переменных является nil.

...

Существует три вида переменных, различающихся своей областью видимости:

• Переменные, видимые в пределах одного модуля в одном потоке.
  Доступны для чтения и записи. Названия таких переменных начинаются с символа $. Такие переменные удобно использовать для хранения значений промежуточных операций и вычислений.
• Переменные, видимые в пределах одного модуля в разных потоках.
  Доступны для чтения и записи. Названия переменных уровня модуля начинаются с символа #. Поскольку такие переменные видны во всех потоках бота их удобно использовать для взаимодействия между потоками. 
• Глобальные переменные или переменные окружения.
  Автоматически задаваемые переменные, которые видны во всех потоках всех модулей бота. Эти переменные доступны только для чтения и хранят информацию о глобальном контексте работы бота. Их имена

...

• начинаются с символа @

...

• .

// Переменные $p и $r доступны только в потоке, в котором они определены
$p = 2 * 3.14 * $r

// Эта переменная доступна во всех потоках в пределах текущего модуля
// (модуля, в котором находится блок операций, в котором определена переменная).
#count = queue.size()

// @communicationType глобальная переменная только для чтения. Доступна 

везде.
$isChat = @communicationType == "TEXT"

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

...

использовать любое название. Для этого необходимо заключить название переменной в круглые скобки

...

.

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

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

Язык выражений бота

...

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

...

означает, что значением одной переменной может быть имя другой переменной

...

или любое выражение, значением которого является строка.

В примере ниже мы определяем три переменные, содержащие названия цветов. Затем мы определяем случайно число от 1 до 3 и далее формируем название одной из переменных с тем, чтобы узнать значение случайного цвета.

// Создадим три переменные с именами x1, x2 и x3
$x1 = "red"
$x2 = "blue"
$x3 = "green"

// Случайное число от 1 до 3
$n = math.rand(1, 3)

// Получаем цвет динамически сформировав имя переменной с цветом и взяв её значение 
$color = $("x" 

:: $n)

Можно также использовать значения переменных разных типов

...

.

// $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 содержит ЛОЖЬ

Объекты

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

Например,

...

с помощью следующего кода можно получить первое сообщение клиента, которое является объектом ClientMessage и далее

...

получить свойство message (текст сообщения) этого объекта

...

.

// $first содержит значение объекта ClientMessage 
$first = queue.first()

// Получаем значение свойства message
$firstMessage = $first.message

Свойства и методы объектов

...

(также как и значения переменных

...

) могут быть вычисляемыми

...

.

$n = rand(0, 1)                     // $n содержит или 0 или 1
$method = ["first", "last"].get($n) // $method содержит строку first или last (см. получение элемента списка по индексу)
$firstOrLast = queue.$method        // Получаем первое или последнее сообщение клиента

// Или даже так
$firstOrLast = queue.(["first", "last"].get($n))

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

Кортежи

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

...

.

$items = (1, 2, 2) // Кортеж из трёх элементов.
$items = ('a',)    // Кортеж из одного элемента. Запятая необходима, чтобы отличать создание кортежа от просто круглых скобок.
$items = ()        // Кортеж не содержащий ни одного элемента (пустой кортеж).

Для работы с кортежами доступны следующие методы

...

.

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(3)
(1, 2, 3).contains(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 – это изменяемая, упорядоченная коллекция произвольных элементов. Создать список можно с помощью квадратных скобок.

 = [1, 2, 

2] // Список из трёх элементов
$items = ['a']     // Список из одного элемента
$items = []        // Список не содержащий ни одного элемента (пустой список)

$items

$items = [1, 2, 2] // Список из трёх элементов
$items = ['a']     // Список из одного элемента
$items = []        // Список не содержащий ни одного элемента (пустой список)

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()

reverse()

Для работы со списками доступны следующие методы.

count()

[1, 2, 3].

...

count()

...

...

...

first(

...

)

...

[1, 2, 3].

...

first()

last()

[1, 2, 3

...

prepend(item)

].last()

has(index)

...

[1, 2, 3].

...

has(0)
[

...

1, 2, 3]

...

shift()

...

.has(3)

get(index)

...

pop()

...

[1, 2, 3]

...

$y будет содержать 1, а $x станет равным [2, 3]

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

[1, 2, 3]

...

$y будет содержать 3, а $x станет равным [1, 2]

...

set(index, item)

...

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

...

$y содержит [1, 0, 3]
$z содержит [1, 2, 3, nil, nil, 'a']

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

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

toTuple()

[1, 2, 3].toTuple()

clear()

$x

...

remove(index)

...

 = [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) – это изменяемая, упорядоченная коллекция произвольных пар ключ/значение. Создаётся словарь с помощью фигурных скобок.

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

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

$items = 

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

hash()

['a', true].hash()

$items = {'a': 1, 'b': 2, 'c': 3} // Словарь из трёх элементов
$items = {1: true}                // Cловарь из одного элемента
$items = {}                       // Словарь не содержащий ни одного значения (пустой словарь)

Для работы со словарями доступны следующие методы:

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)

true
false

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

c
nil

has(key)

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

 // Словарь из трёх элементов
$items = {'a': 

true
false

get(key)

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

2
nil

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

$x будет содрежать {1: true, 2: false}

$x = {'a': 1, 'b': 2}
$y = $x.remove('a')

$y будет содержать 1, а $x станет равным {'b': 2}

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

Устанавливаются те биты, которые не установлены в $a, и наоборот

$a & $b

$a | $b

$a ^ $b

Устанавливаются только те биты, которые установлены либо только в $a, либо только в $b, но не в обоих одновременно

Таблица преобразования других типов данных в число:

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

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

!$a

$a && $b

$a || $b

Таблица преобразования других типов данных в булевое значение:

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

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

"a" + "b"

Если первый аргумент оператора "+" не является строкой, то будет выполняться арифметическая операция сложения. Если второй аргумент операции конкатенации не является строкой, то он будет преобразован в строку согласно следующей таблицы преобразования:

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

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

$a == $b

true если $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}

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

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

$a = 123

$a += 1

$a -= 1

$a *= 2

$a /= 2

$a \= 2

$a %= 5

$a **= 3

$a &= 1

$a |= 3

$a ^= 4

Кроме присваивания значения одной переменной есть возможность присвоить значение сразу нескольким переменным:

($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, работать с очередью сообщений клиента и т.д.

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

$number = math.rand(5, 10) // Получаем случайное число от 5 до 10. math - название модуля, rand - название функции

Также как и в случае методов объектов имена функций могут динамически вычисляться в процессе выполнения сценария бота.

$funcIdx = math.rand(0, 1)                          // Получаем случайное число 0 или 1 которое будет индексом названия функции в кортеже
$number = math.(('min', 'max').get($funcIdx))(3, 7) // Получаем название функции min или max и далее вызываем её. Таким образом мы вычисляем случайным образом либо минимальное либо максимальное значение 

On this page:

In the operation / expression block, you can specify an arbitrary number of operations for the bot to calculate. These operations are expressions are written using a subset of the conversational bot programming language that is described below.

Structure of operations

All bot operations contained in one block represent one or multiple expressions in the bot programming language. Expressions are separated from each other by an optional character ";", or a newline character (beginning of a new line). Every expression has a value. This means that expressions can be compound.

Comments

When you are writing expressions, you can use comments. Comments are sections of the program that do not participate in calculations but are meant for informational purposes only.

There are two types of comments:

• Single-line comments. Such comments begin with two slashes // and end at the end of the line.
• Multi-line comments. Multiline commentsstart with /* and end with */

Example of comments:

// These are single-line comments
$x = time()

/**
 * And these are
 * multi-line
 * comments
 */
say("Time is " + $x)

Variables

Variables are used to store data in bot scripts. A variable represents a named location in the bot's memory. It is created the first time it is used in a block of operations. Nil is the default value for all variables.

There are three types of variables. They are distinguished by the scope:

• Variables visible within the same module in one thread. These variables can be used for reading and writing values. Their names begin with the symbol $. Such variables are useful for storing intermediate operations and calculations.
• Variables visible within the same module in different threads. These variables can be used for reading and writing values. Their names begin with the symbol #. Since such variables are visible in all threads of the bot, they are useful for interaction between threads.
• Global variables or environment variables. These variables are defined automatically. They are visible in all threads of all bot modules. These variables are read-only and store information about the global context of the bot. Their names start with the symbol @.

Examples of different types of vaiables:

// Variables $p and $r are only available in the thread in which they are defined
$p = 2 * 3.14 * $r

// This variable is available in all threads within the current module
// (the module where the block of operations is located in which the variable is defined).
#count = queue.size()

// @communicationType is a read-only global variable. It is available from everywhere. 
$isChat = @communicationType == "TEXT"

Variable names can contain only numbers, English and Russian letters, and underscores. I.e., you cannot name a variable with a word that contains a space or a character other than Russian and English. However, there is a way to specify any name you want. For this, enclose the variable name in parentheses:

$('日本') = 123         // Created a variable with name 日本
$x = $('日本')          //  $x is now 123
$(math.rand(1, 2)) = 0 // Dynamically create a variable with name 1 or 2 and assign it value 0

Variable variables

The bot expression language allows you to dynamically calculate the name of a variable while the bot is running. This means that the name of one variable can be the value of another variable. Or a variable name can be any expression whose value is a string.

In the example below, we define three variables that contain names of the colors. Then on the random basis we determine a number in the range from 1 to 3 and then create a name for one of these variables to find out the value of a random color.

// Create three variables with names x1, x2 and x3
$x1 = "red"
$x2 = "blue"
$x3 = "green"

// Random number in the ramge from 1 to 3 $n = math.rand(1, 3)

// Get the color dynamically generating the name for a variable with the color and using its value
$color = $("x" + $n)

You can also use variable values ​​of different types:

// $x contains the name of variable #y
$x = "y"

// #y contains the name of the global variable communicationType
#y = "communicationType"

// Calculated in the following way @#$x -> @#("y") -> @#y -> @("communicationType") -> @communicationType
$communicationType = @#$x

Data types

There are three primitive data types. One of them is the object type and another is the special value nil

Numbers

All numbers are treated as real signed numbers with a floating point. The minimum and maximum values ​​are determined by the computing environment where the interpreter of the expression language is functioning.

Strings

Strings represent an arbitrary sequence of characters enclosed in single or double quotes. Double quotes differ from single quotes so that the following special character sequences are recognized within them:

In single quotes all characters are treated as is except for the sequence \'  that means a single quote character.

// The following command displays a two-line phrase in the chat 
// Hello
// "Medved!"
say("Hello\n\"Medved!\"")

// Will display a phrase in the chat Hello\n'Medved!'
say('Hello\n\'Medved!\'')

Boolean (logical) values

Constants true and false are boolean, i.e. their values can have only one of the following states: true and false. Boolean values ​​are useful in an expression of the conditional block .

$x = true  // $x contains TRUE
$y = !$x   // $y contains FALSE

Objects

In the standard library of the bot programming language, there are functions (operations) whose values are so-called objects. An object is a special value that can have built-in properties and operations or methods. The combination of these properties and methods is determined by the type of the object. To access properties or methods of objects, the dot operator "." is used.

For example, below we receive the first message from the client that is a ClientMessage object. Then we use the message property (message text) of that object:

// $first contains the value of the ClientMessage object
$first = queue.first()

// Receive the value of the message property 
$firstMessage = $first.message

Object properties and methods as well as variable values can be calculated:

$n = rand(0, 1)                     // $n contains either 0 or 1
$method = ["first", "last"].get($n) // $method contains the string first or last (see getting a list element by index) 
$firstOrLast = queue.$method        // Receive the first or last client message
// Or even like this
$firstOrLast = queue.(["first", "last"].get($n))

There are three types of built-in objects that are collections of arbitrary elements.

Tuples

A tuple is an unchangeable ordered collection of arbitrary elements. You can create a tuple with parentheses:

$items = (1, 2, 2) // Tuple with one element
$items = ('a',)    // Tuple with one element. The comma is used to distinguish the creation of a tuple from parentheses. 
$items = ()        // Tuple without elements (empty tuple)

The following methods are used to work with tuples:

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)

Returns an element in a tuple by its index or returns nil if such element is absent

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

2
nil

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

true
false

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

2
-1

equals(other)

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

hash()

Returns a string that represents the hash of the tuple (a value that identifies the contents of the tuple)

('a', true).hash()

Lists

A list is a changeable ordered collection of arbitrary elements. You can create a list with square brackets:

$items = [1, 2, 2] // List with three elements
$items = ['a']     // List with one element
$items = []        // List without elements (empty list)

The following methods are used to work with lists:

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)

2
nil

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

true
false

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

0
-1

toTuple()

[1, 2, 3].toTuple()

(1, 2, 3)

clear()

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

$x contains empty list []

reverse()

[1, 2, 3].reverse()

[3, 2, 1]

append(item)

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

[1, 2, 3, 4]

prepend(item)

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

[0, 1, 2, 3]

shift()

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

$y will contain 1 and $x will be equal to [2, 3]

pop()

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

$y will contain 3 and $x will be equal to [1, 2]

set(index, item)

Adds a value to the specified position on the list. If the position is located outside the list, then it will be expanded with zero values ​​to the necessary size.

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

$y contains [1, 0, 3]
$z contains [1, 2, 3, nil, nil, 'a']

remove(index)

Deletes the element at the specified position on the list and returns its value

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

$y will contain 2 and $x will be equal to [1, 3]

equals(other)

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

hash()

['a', true].hash()

Associative arrays (dictionaries)

An associative array or dictionary (map) is a mutable ordered collection of arbitrary key/value pairs. A dictionary is created with curly braces:

$items = {'a': 1, 'b': 2, 'c': 3} // Dictionary of three elements
$items = {1: true}                // Dictionary of one element
$items = {}                       // Dictionary without any elements (empty dictionary)

The following methods are used to work with dictionaries:

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()

true}                // Cловарь из одного элемента
$items = {}                       // Словарь, не содержащий ни одного значения (пустой словарь)

Для работы со словарями доступны следующие методы.

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}.

...

keys()

...

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

...

has('d')

...

firstKey()

...

get(key)

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

...

get(

...

'

...

b'

...

)

...

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

...

get('d')

...

first()

...

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

...

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

...

last()

...

...

...

...

contains(item)

equals(other)

...

{'a': 

...

'b'}.equals(['a': 

...

'

...

b'])
{'a': 

...

'b'}.equals(['b':

...

 '

...

a'])

...

hash()

{'a': true}.hash()

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

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

Special value nil

When a variable is not defined but is already used in an expression, its value becomes nil. This is a special value that means the absence of any value. This value can also be assigned explicitly.

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()

$x = 1 + 2 // $x 

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

содержит nil

Операции

В языке выражений бота определенно несколько бинарных и унарных операций. Некоторые операции могут быть применены к разным типам данных. Тип результата операции определяется видом операции. Например, операция "::" принимает в качестве аргументов строки. Поэтому все операнды этой операции будут неявно преобразованы к строке.

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

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

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

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

...

Арифметические операции предназначены для работы с числами.

...

Если значение, участвующее в арифметической операции

...

Arithmetic operations are used to work with numbers. If the value used in the arithmetic operation is not a number, ther will be an attempt to convert it to a number (see below).

...

+$a

...

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

...

-$a

...

Пример	Результат
+$a	Преобразование $a в число
-$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

...

Возведение $a в степень $b

Bitwise operations

This is a separate class of operations used to work with bit representations of integers.

...

~$a

...

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

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

~$a

$a & $b

...

$a | $b

...

$a ^ $b

...

...

...

Sets only those bits that are set to either $a or $b, but not to both of them

Таблица преобразования других типов данных в число.

Table for conversion of other data types to a number:

...

...

...

...

...

...

...

...

...

...

Logical operations

...

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

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

!$a

...

...

...

$a && $b

...

...

...

...

$a || $b

...

...

...

...

...

Таблица преобразования других типов данных в булево значение.

Table for convertion of other data types to a boolean value:

...

...

...

...

...

...

...

Operations with strings

Only one operation is used to work with strings. This operation is called the addition or concatenation of strings.

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

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

...

"a" 

...

:: "b"

If the first argument of the concatenation operation is not a string, then the addition is performed. If the second argument is not a string, then it is converted to a string according to the following conversion table:

...

Если аргумент операции конкатенации не является строкой, то он будет преобразован в строку согласно следующей таблицы преобразования.

...

...

...

...

...

...

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

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

Comparison operations

Comparison operations are used to work with any data types. Calculation results are boolean values.

...

$a == $b

...

$a != $b

...

$a > $b

...

$a >= $b

...

$a < $b

...

$a <= $b

...

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

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

Operations with collections

There is a union operation that is used for embedded object types: tuple, list, and map.

...

(1, 2) + (3, 4)

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

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

Assignment operations

Assignment operators allow to assign a value to variable.

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

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

...

$a = 123

...

$a += 1

$a -= 1

$a *= 2

$a /= 2

$a \= 2

$a %= 5

$a **= 3

$a &= 1

$a |= 3

$a ^= 4

Apart from assigning a value to a variable, you can also assign a value to several variables at once.

...

Кроме присваивания значения одной переменной есть возможность присвоить значение сразу нескольким переменным.

...

($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, работать с очередью сообщений клиента и т.д.

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

Functions

Function calls are basic blocks that are used to build expressions in an operation block. A function is a part of a bot's functionality. For example, using functions you can work with date and time, perform complex arithmetic operations, convert a text string to intents using the NLU service, work with the client's message queue, etc.

To call a function, you need to specify its name, then list its parameters separated by a comma in parentheses. Names of most functions contain two parts separated by a dot: the name of the module and the name of the function itself.

функции

$number = math.rand(5, 10) // 

Получаем 

случайное 

число от 5 

до 10. math 

– 

название 

модуля, rand 

– 

название 

Также как и в случае методов объектов имена функций могут динамически вычисляться в процессе выполнения сценария бота.

$funcIdx = math.rand(0, 1)                          // 

Получаем 

случайное число 0 или 1, которое будет индексом названия функции в кортеже.
$number = math.(('min', 'max').get($funcIdx))(3, 7) // 

Получаем 

название 

функции 

min 

или max 

и 

далее 

вызываем 

её. 

Таким 

образом, 

мы 

вычисляем 

случайным 

образом 

либо 

минимальное, 

либо 

максимальное значение.