Якорь

	Top
	Top

CSS Stylesheet

...

...

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

Оглавление

...

class	bpl

...

TopTop

В одинарных кавычках все символы тарктуются как есть за исключением последовательности \' которая означает символ одинарной кавычки.

Предупреждение

title	Внимание

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

HTML

<a href="

CSS Stylesheet

.top-button {
		background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/baseline_keyboard_arrow_up_white_18dp.png) !important;
		background-position: center;
		background-color: #47a7f5 !important;
		background-repeat: no-repeat;
		box-shadow: -1px 1.5px 3px #999;
		color: #47a7f5 !important;
		border-radius:50px !important;
        position: fixed;
        bottom: 45px;
        left: 93.5%;
        width: 50px;
		height: 50px !important;
        font-size: 12px !important;
        padding: 14.5px !important;
		z-index: 2;
}
.top-button:hover{
		background-color: #65b9ff !important;
        color: #65b9ff !important;
}
.page-header{
		background-color: #232838;
	    background-repeat: no-repeat;
	    background-position: center;
		width: auto;
    	height: 100px;
		background-image: url(https://confluence.twin24.ai/download/attachments/23986188/logo_twin-02.png);
		background-size: 10em;
        color: #fff;
        font-size: 20px;
        padding: 20px;
}
.page-footer{
		background-color: #232838;
		background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/decorated-pattern-dark.png);
		width: auto;
    	height: 10px;
        color: #fff;
		text-align: end;
    	font: small-caption;
    	padding-inline-end: 30px;
    	padding-top: 200px;
    	padding-bottom: 30px;
}
.page-headline{
		background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/Solid256dot8_2changed.png);
    	background-repeat: no-repeat;
    	background-position-x: -227px;
    	background-position-y: center;
    	padding: 20px;
		background-color: #007bff;
		width: auto;
    	height: 10px;
        color: #fff;
		text-align: center;
    	font: caption;
    	font-weight: 600;
}
.tabs-menu{
    	padding-left: 85% !important;
}

Предупреждение

title	Внимание

BPL-операции работают только в чатах и во входящих звонках. Для тестирования сценариев, использующих BPL-операции, используйте чат в виджете.

Как создать тестовый виджет: Создание тестового виджета

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

Оглавление

class	bpl

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

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

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

Однострочные. Такие комментарии начинаются с двух слэшей // и заканчиваются окончанием строки.
Многострочные. Начало многострочного комментарии начинается с /* и заканчивается */

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

Блок кода

language	text

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

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

Переменные

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

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

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

Примеры записей переменных разных видов:

Блок кода

language	text

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

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

// @communicationType глобальная переменная только для чтения. Доступна отовсюду.
$isChat = @communicationType == "TEXT"

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

Блок кода

language	text

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

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

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

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

Блок кода

language	text

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

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

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

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

Блок кода

language	text

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

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

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

Типы данных

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

Числа

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

Строки

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

Последовательность

Значение

\n

Перевод строки

\r

Возврат каретки

\t

Горизонтальная табуляция

\"

Двойная кавычка

Блок кода

language	text

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

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

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

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

Блок кода

language	text

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

Объекты

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

Например, следующий код получает первое сообщение клиента которое является объектом ClientMessage и далее берёт свойство message (текст сообщения) этого объекта:

Блок кода

language	text

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

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

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

Блок кода

language	text

$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 это неизменяемая упорядоченная коллекция произвольных элементов. Создать кортеж можно с помощью круглых скобок:

Блок кода

language	text

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

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

МетодОписаниеПримерРезультат

count()

Получение количества элементов кортежа

(1, 2, 3).count()

3

first()

Получение первого элемента кортежа

(1, 2, 3).first()

1

last()

Получение последнего элемента кортежа

(1, 2, 3).last()

3

has(index)

Возвращает true, если кортеж содержит элемент с указанным порядковым номером и false в противном случае

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

true
false

get(index)

Возвращает элемент кортежа по его порядковому номеру или nil если такого элемента нет

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

2
nil

contains(item)Возвращает true, если кортеж содержит элемент item и false в противном случае

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

true
false

index(item)Возвращает порядковый номер элемента item, либо -1 если такого элемента нет

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

2
-1

equals(other)

Возвращает true, если other представляет собой точно такой же кортеж (т.е. кортеж содержащий те же самые элементы) и false в противном случае

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

true
false

hash()

Возвращает строку, представляющую собой хэш кортежа (значение уникально идентифицирующее содержимое кортежа)

('a', true).hash()

bb2fadd01f7d0ac9864dc963a61f653f

Списки

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

Блок кода

language	text

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

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

МетодОписаниеПримерРезультат

count()

Получение количества элементов списка

[1, 2, 3].count()

3

first()

Получение первого элемента списка

[1, 2, 3].first()

1

last()

Получение последнего элемента списка

[1, 2, 3].last()

3

has(index)

Возвращает true, если список содержит элемент с указанным порядковым номером и false в противном случае

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

true
false

get(index)

Возвращает элемент списка по его порядковому номеру или nil если такого элемента нет

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

2
nil

contains(item)Возвращает true, если список содержит элемент item и false в противном случае

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

true
false

index(item)Возвращает порядковый номер элемента item, либо -1 если такого элемента нет

[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 содержит пустой список []

reverse()

Меняет порядок следования элементов списка на обратный

[1, 2, 3].reverse()

[3, 2, 1]

append(item)

Добавляет переданное значение item в конец списка

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

[1, 2, 3, 4]

prepend(item)

Добавляет переданное значение item в начало списка

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

[0, 1, 2, 3]

shift()

Удаляет и возвращает первый элемент списка

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

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

pop()

Удаляет и возвращает последний элемент списка

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

$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']

remove(index)

Удаляет элемент списка в указанной позиции и возвращает его значение

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

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

equals(other)

Возвращает true, если other представляет собой точно такой же список (т.е. список содержащий те же самые элементы) и false в противном случае

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

true
false

hash()

Возвращает строку, представляющую собой хэш списка (значение уникально идентифицирующее содержимое списка)

['a', true].hash()

bb2fadd01f7d0ac9864dc963a61f653f

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

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

Блок кода

language	text

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

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

МетодОписаниеПримерРезультат

count()

Получение количества элементов словаря

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

3

clear()

Удаление всех элементов словаря

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

$x станет содержать пустой словарь

reverse()

Меняет порядок следования элементов словаря на обратный

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

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

values()

Возвращает список состоящий из всех значений словаря

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

[1, 2, 3]

keys()

Возвращает список состоящий из всех ключей словаря

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

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

firstKey()

Получение первого ключа словаря

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

'a'

lastKey()

Получение последнего ключа словаря

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

'c'

first()

Получение первого элемента словаря

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

1

last()

Получение последнего элемента словаря

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

3

contains(item)

Возвращает true, если словарь содержит элемент item и false в противном случае

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

true
false

key(item)Возвращает ключ соответствующий значению item или nil в противном случае

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

c
nil

has(key)

Возвращает true, если элемент с указанным ключом сущеcтвует и false в противном случае

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

true
false

get(key)

Возвращает элемент словаря по его ключу или nil если такого элемента нет

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

2
nil

set(key, item)Устанавливает элемент словаря с заданным ключом

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

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

remove(key)Удаляет элемент словаря по ключу и возвращает его значение

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

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

equals(other)

Возвращает true, если other представляет собой точно такой же словарь (т.е. словарь содержащий те же самые ключи и значения) и false в противном случае

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

true
false

hash()

Возвращает строку, представляющую собой хэш словаря (значение уникально идентифицирующее содержимое словаря)

{'a': true}.hash()

bb2fadd01f7d0ac9864dc963a61f653f

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

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

Блок кода

language	text

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

Операции

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

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

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

ОперацияПриоритетАссоциативностьОписание**12праваяВозведение в степень+11-Унарный плюс-11-Унарный минус~11-Побитовая инверсия!10-Логическое отрицание*9леваяУмножение/9леваяДеление\9леваяЦелочисленное деление%9леваяОстаток от деления+8левая

Сложение, конкатенация, объединение

-8леваяВычитание<7-Меньше чем<=7-Меньше или равно>7-Больше чем>=7-Больше или равно==6-Равно!=6-Не равно&5леваяПобитовое И^4леваяПобитовое исключающее ИЛИ|3леваяПобитовое ИЛИ&&2леваяЛогическое И||1леваяЛогическое ИЛИ=0праваяПрисваивание+=0праваяСложение с присваиванием-=0праваяРазность с присваиванием*=0праваяУмножение с присваиванием/=0праваяДеление с присваиванием\=0праваяЦелочисленное деление с присваиванием%=0праваяОстаток от деления с присваиванием**=0праваяВозведение в степень с присваиванием&=0праваяБинарное И с присваиванием^=0праваяБинарное исключающее И с присваиванием|=0праваяБинарное ИЛИ с присваиванием

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

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

ПримерРезультат

+$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

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

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

ПримерРезультат

~$a

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

$a & $b

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

$a | $b

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

$a ^ $b

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

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

ТипЗначениеРезультатNILnil0Логическийtrue1Логическийfalse0Строка""0Строка"123.5"123.5Строка"abc"ошибкаОбъектлюбойошибка

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

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

ПримерРезультат

!$a

true, если $a равно false и false в противном случае

$a && $b

true, если $a и $b true, false в противном случае

$a || $b

false, если $a и $b false, true в противном случае

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

ТипЗначениеРезультатNILnilfalseЧисло0falseЧислолюбое ненулевоеtrueСтрока""falseСтрокалюбая непустаяtrueОбъектлюбойtrue

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

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

ПримерРезультат

"a" + "b"

"ab"

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

ТипЗначениеРезультатNILnil""Число123.45"123.45"Логическийtrue"true"Логическийfalse"false"Объектлюбойсериализация в строку

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

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

ПримерРезультат

$a == $b

true если $a тождественно равно $b

$a != $b

true если $a тождественно не равно $b

$a > $b

true если $a больше $b

$a >= $b

true если $a больше или равно $b

$a < $b

true если $a меньше $b

$a <= $b

true если $a меньше или равно $b

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

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

ПримерРезультат

(1, 2) + (3, 4)

(1, 2, 3, 4)

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

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

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

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

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

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

ПримерРезультат

$a = 123

$a содержит 123

$a += 1

$a = $a + 1

$a -= 1

$a = $a - 1

$a *= 2

$a = $a * 2

$a /= 2

$a = $a / 2

$a \= 2

$a = $a \ 2

$a %= 5

$a = $a % 5

$a **= 3

$a = $a ** 3

$a &= 1

$a = $a & 1

$a |= 3

$a = $a | 3

$a ^= 4

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

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

Блок кода

language	text

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

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

Блок кода

language	text

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

English (US)

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

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

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

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

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

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

Блок кода

language	php
theme	DJango
firstline	1
title	Пример комментариев
linenumbers	true

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

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

Переменные

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

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

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

Блок кода

language	php
theme	DJango
firstline	1
title	Примеры записей переменных разных видов
linenumbers	true

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

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

// @communicationType глобальная переменная только для чтения. Доступна везде.
$isChat = @communicationType == "TEXT"

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

Блок кода

language	php
theme	DJango
firstline	1
title	Пример использования
linenumbers	true

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

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

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

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

Блок кода

language	php
theme	DJango
firstline	1
title	Пример использования
linenumbers	true

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

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

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

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

Блок кода

language	php
theme	DJango
firstline	1
title	Пример использования
linenumbers	true

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

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

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

Типы данных

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

Числа

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

Строки

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

Последовательность	Значение
\n	Перевод строки
\r	Возврат каретки
\t	Горизонтальная табуляция
\v
\"	Двойная кавычка

В одинарных кавычках все символы трактуются как есть за исключением последовательности символов \', которая означает символ одинарной кавычки.

Блок кода

language	php
theme	DJango
firstline	1
title	Пример использования
linenumbers	true

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

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

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

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

Блок кода

language	php
theme	DJango
firstline	1
title	Пример использования
linenumbers	true

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

Объекты

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

Например, с помощью следующего кода можно получить первое сообщение клиента, которое является объектом ClientMessage и далее получить свойство message (текст сообщения) этого объекта.

Блок кода

language	php
theme	DJango
firstline	1
title	Пример использования
linenumbers	true

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

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

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

$('日本') = 123

//

Created

$n

a

содержит

variable

или

with

name

или

日本

$x

$method =

$('日本') // $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.

Блок кода

language	php
theme	DJango
firstline	1
title	Пример использования
linenumbers	true

$n = rand(0, 1)

On this page:

Оглавление

class	bpl

Предупреждение

title	Внимание

BPL operations are used only in chats and incoming calls. To test scripts that use BPL operations, use a chat in the web widget.

Learn how to create a test widget

In the operations / expressions 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:

Блок кода

language	py
theme	DJango
linenumbers	true
collapse	true

// 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:

Блок кода

language	text

// 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:

Блок кода

language	text

Блок кода

language	text

// 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:

Блок кода

language	text

// $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:

SequenceDescription\nTranslation to new line\rCarriage return\tHorizontal tab\"Double quote

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

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

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

Кортежи

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

Блок кода

language	php
theme	DJango
firstline	1
title	Пример использования
linenumbers	true

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

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

	Метод	Описание	Пример	Результат
1	count()	Получение количества элементов кортежа	(1, 2, 3).count()	3
2	first()	Получение первого элемента кортежа	(1, 2, 3).first()	1
3	last()	Получение последнего элемента кортежа	(1, 2, 3).last()	3
4	has(index)	Возвращает true, если кортеж содержит элемент с указанным порядковым номером, и false в противном случае	(1, 2, 3).has(0) (1, 2, 3).has(3)	true false
5	get(index)	Возвращает элемент кортежа по его порядковому номеру или nil, если такого элемента нет	(1, 2, 3).get(1) (1, 2, 3).get(3)	2 nil
6	contains(item)	Возвращает 1, если кортеж содержит элемент item, и ничего (void) в противном случае.	(1, 2, 3).contains(3) (1, 2, 3).contains(0)	true false
7	index(item)	Возвращает порядковый номер элемента item либо -1, если такого элемента нет	(1, 2, 3).index(3) (1, 2, 3).index(0)	2 -1
8	equals(other)	Возвращает true, если other представляет собой точно такой же кортеж (т.е. кортеж, содержащий те же самые элементы), и false в противном случае	('a', 'b').equals(('a', 'b')) ('a', 'b').equals(('b', 'a'))	true false
9	hash()	Возвращает строку, представляющую собой хэш кортежа (значение, уникально идентифицирующее содержимое кортежа)	('a', true).hash()	bb2fadd01f7d0ac9864dc963a61f653f
10	copy()	Создаёт поверхностную копию кортежа (т.е. не копирует коллекции внутри кортежа).	$list = ["a", "b"] $copy = (1, 2, $list).copy() $copy.get(2).append("c")	$list будет равен ["a", "b", "c"] $copy будет равен (1, 2, ["a", "b", "c"])
11	deepCopy()	Создаёт полную копию кортежа.	$list = ["a", "b"] $copy = (1, 2, $list).deepCopy() $copy.get(2).append("c")	$list будет равен ["a", "b"] $copy будет равен (1, 2, ["a", "b", "c"])
12	merge(collection)	Возвращает новый кортеж полученный из слияния текущего кортежа с коллекций (другим кортежем, списком или словарём)	(1, 2, 3).merge((4, 5)) (1, 2, 3).merge([3, 4]) (1, 2, 3).merge({"a": 1, "b": 2})	(1, 2, 3, 4, 5) (1, 2, 3, 3, 4) (1, 2, 3, 1, 2)

Списки

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

$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:

Result

 Список не содержащий ни одного элемента (пустой список)

Блок кода

language	php
theme	DJango
firstline	1
title	Пример использования
linenumbers	true

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

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

Блок кода

language	text

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

Блок кода

language	text

$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:

Блок кода

language	text

// $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:

Блок кода

language	text

$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:

Блок кода

language	text

Method

Description

Example

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

Метод	Описание	Пример	Результат
count()

...

Получение количества элементов списка

...

1, 2, 3

...

].count()	3
first()

...

Получение первого элемента списка

...

1, 2, 3

...

].first()	1
last()

...

Получение последнего элемента списка

...

1, 2, 3

...

].last()	3
has(index)

...

Возвращает true, если список содержит элемент с указанным порядковым номером, и false в противном случае

...

1, 2, 3

...

].has(0)

...

[1, 2, 3

...

].has(3)	true false
get(index)

...

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

Возвращает элемент списка по его порядковому номеру или nil, если такого элемента нет

...

1, 2, 3

...

].get(1)

...

[1, 2, 3

...

].get(3)	2 nil
contains(item)

...

Возвращает true,

...

если список содержит элемент item, и false в противном случае

...

1, 2, 3

...

].contains(

...

1)

...

[1, 2, 3

...

].contains(0)	true false
index(item)

...

Возвращает порядковый номер элемента item либо -1, если такого элемента нет

...

1, 2, 3

...

].index(

...

1)

...

[1, 2, 3

...

].index(0)

...

0
-1

...

toTuple(

...

Lists

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

...

language	text

...

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

...

Возвращает кортеж, состоящий из элементов данного списка	[1, 2, 3].toTuple()	(1, 2, 3)
clear()	Удаляет все элементы списка	$x = [1, 2, 3] $x.clear()	$x содержит пустой список []
reverse()	Меняет порядок следования элементов списка на обратный	[1, 2, 3].reverse()	[3, 2, 1]
append(item)	Добавляет переданное значение item в конец списка

[1, 2,

...

The following methods are used to work with lists:

...

count()

...

3].append(4)	[1, 2, 3, 4]
prepend(item)	Добавляет переданное значение item в начало списка	[1, 2, 3].

...

prepend(0)

[0, 1, 2, 3]

...

shift()

...

Удаляет и возвращает первый элемент списка

$x = [1, 2, 3]

...


$y = $x.shift()

$y будет содержать 1

...

last()

...

, а $x станет равным [2, 3]
pop()	Удаляет и возвращает последний элемент списка	$x = [1, 2, 3]

...

has(index)

...

$y = $x.pop()	$y будет содержать 3, а $x станет равным [1, 2]
set(index, item)	Добавляет значение в указанную позицию списка. Если позиция лежит за пределами списка, то он будет расширен нулевыми значениями до нужного размера.	$x = [1, 2, 3]

...


$y = $x.set(1, 0)

...

get(index)

...

$z = $x.set(5, 'a')	$y содержит [1, 0, 3] $z содержит [1, 2, 3, nil, nil, 'a']
remove(index)	Удаляет элемент списка в указанной позиции и возвращает его значение	$x =

...

[1, 2, 3]

...

2
nil

$y = $x.remove(1)	$y будет содержать 2, а $x станет равным [1, 3]
equals(other)	Возвращает true, если other представляет собой точно такой же список (т.е. список, содержащий те же самые элементы), и false в противном случае	['a', 'b'].equals(['a', 'b']) ['a', 'b'].equals(['b', 'a']

...

)	true false

...

hash(

...

[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:

Блок кода

language	text

$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', true].hash()	bb2fadd01f7d0ac9864dc963a61f653f
copy()	Создаёт поверхностную копию списка (т.е. не копирует коллекции внутри списка).	$list = ["a", "b"] $copy = [1, 2, $list].copy() $copy.get(2).append("c")	$list будет равен ["a", "b", "c"] $copy будет равен [1, 2, ["a", "b", "c"]]
deepCopy()	Создаёт полную копию списка.	$list = ["a", "b"] $copy = [1, 2, $list].deepCopy() $copy.get(2).append("c")	$list будет равен ["a", "b"] $copy будет равен [1, 2, ["a", "b", "c"]]
merge(collection)	Сливает текущий список с коллекций (другим кортежем, списком или словарём) и возвращает его.	["a", "b"].merge((1, 2)) ["a", "b"].merge(["a", "c"]) ["a", "b"].merge({"a": 1, "b": 2})	["a", "b", 1, 2] ["a", "b", "a", "c"] ["a", "b", 1, 2]

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

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

Блок кода

language	php
theme	DJango
firstline	1
title	Пример использования
linenumbers	true

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

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

Метод	Описание	Пример	Результат
count()	Получение количества элементов словаря	{1: 'a', 2: 'b', 3: 'c'}.count()	3
clear()	Удаление всех элементов словаря	$x = {true: false, 'b': true} $x.clear()	$x будет содержать пустой словарь
reverse()	Меняет порядок следования элементов словаря на обратный	{'a': 1, 'b': 2, 'c': 3}.reverse()	{'c': 3, 'b': 2, 'a': 1}
values()	Возвращает список, состоящий из всех значений словаря	{'a': 1, 'b': 2, 'c': 3}.values()	[1, 2, 3]
keys()	Возвращает список, состоящий из всех ключей словаря	{'a': 1, 'b': 2, 'c': 3}.keys()	['a', 'b', 'c']
firstKey()	Получение первого ключа словаря	{'a': 1, 'b': 2, 'c': 3}.firstKey()	'a'
lastKey()	Получение последнего ключа словаря	{'a': 1, 'b': 2, 'c': 3}.

...

lastKey()	'c'
first()	Получение первого элемента словаря	{'

...

a':

...

 1, 'b': 2, '

...

c':

...

values()

...

3}.first()	1
last()	Получение последнего элемента словаря	{'a': 1, 'b': 2, 'c': 3}.

...

last()

...

3

...

contains(

...

item)

Возвращает true, если словарь содержит элемент item, и false в противном случае

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

...

contains(2)

...

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

...

firstKey()

...

: 3}.contains(4)	true false
key(item)	Возвращает ключ, соответствующий значению item, или nil в противном случае	{'a':

...

1,

...

'b':

...

2,

...

'c':

...

3}.

...

lastKey()

...

key(3)
{'a':

...

1,

...

'b':

...

2,

...

'c':

...

3}.

...

key(4)

...

c

...

nil

...

has(

...

key)

Возвращает true, если элемент с указанным ключом сущеcтвует, и false в противном случае

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

...

has('a')

...

last()

...

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

...

has('d')

true

...

false

...

get(

...

key)

...

Возвращает элемент словаря по его ключу или nil, если такого элемента нет

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

...

get(

...

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

...

get(

...

'd')

...

2

...

nil

set(key

...

, item)

...

Returns the key that corresponds to the value of item. Otherwiese returns nil.

Устанавливает элемент словаря с заданным ключом	$x = {1: true, 2: nil} $x.set(2, false)	$x будет содержать {1: true, 2: false}
remove(key)	Удаляет элемент словаря по ключу и возвращает его значение	$x = {'a': 1, 'b': 2} $y = $x.remove('a')	$y будет содержать 1, а $x станет равным {

...

'b': 2

...

}
equals(other)	Возвращает true, если other представляет собой точно такой же словарь (т.е. словарь, содержащий те же самые ключи и значения), и false в противном случае	{'a':

...

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

...

c
nil

...

has(key)

...

b'])


{'a':

...

'b'

...

}.equals(['b':

...

'a'])	true false
hash()	Возвращает строку, представляющую собой хэш словаря (значение, уникально идентифицирующее содержимое словаря)	{'a': true}.hash()	bb2fadd01f7d0ac9864dc963a61f653f
copy()	Создаёт поверхностную копию словаря (т.е. не копирует коллекции внутри словаря).	$list = ["a", "b"] $copy = {"a": 1, "b": $list}.copy() $copy.get("b").append("c")	$list будет равен ["a", "b", "c"] $copy будет равен {"a": 1, "b": ["a", "b", "c"]}
deepCopy()	Создаёт полную копию словаря.	$list = ["a", "b"] $copy = {"a": 1, "b": $list}.deepCopy() $copy.get("b").append("c")	$list будет равен ["a", "b"] $copy будет равен {"a": 1, "b": ["a", "b", "c"]}
merge(collection)	Сливает текущий словарь с коллекций (другим кортежем, списком или словарём) и возвращает его.	{"a": true, "b": 123}.merge((1, 2)) {"a": true, "b": 123}.merge([1, 2]) {"a": true, "b": 123}.merge({"a": 321, "c": false}	{"a": true, "b": 123, 0: 1, 1: 2} {"a": true, "b": 123, 0: 1, 1: 2} {"a": 321, "b": 123, "c": false}

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

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

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

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.

textDescription

Блок кода

language	php
theme	DJango
firstline	1
title	Пример использования
linenumbers	true

true
false

get(key)

Returns the element of the dictionary by its key, or returns nil if such element is absent

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

2
nil

set(key, item)

Sets the dictionary element with the given key

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

$x will contain {1: true, 2: false}

remove(key)

Deletes a dictionary element by key and returns its value

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

$y will contain 1 and $x will be equal to {'b': 2}

equals(other)

Returns true if other is exactly the same dictionary (i.e. a dictionary that contains the same keys and values). Otherwise returns false.

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

true
false

hash()

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

{'a': true}.hash()

bb2fadd01f7d0ac9864dc963a61f653f

Блок кода

language

$x = 1 + 2 // $x

contains

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

contains

содержит nil

Operations

The bot expression language has several operation classes. An operation class is determined by its first argument. For example, if the first argument of the "+" operation is a string, then strings are concatenated. If the first argument is a number, then numbers are added.

Priorities of operations

The higher the priority is defined, the earlier the operation is performed. Parentheses are used to increase the priority.

Operation

Priority

Associativity

Операции

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

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

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

Операция	Приоритет	Ассоциативность	Описание
**	12

...

Правая	Возведение в степень
+	11

...

–

...

Унарный плюс
-	11	-

...

Унарный минус
~	11

...

–

...

Побитовая инверсия
!	10

...

–

...

Логическое отрицание
*	9

...

Левая

...

Умножение
/	9

...

Левая

...

Деление
\	9

...

Левая

...

Целочисленное деление
%	9

...

Левая	Остаток от деления
+	8

...

Addition, concatenation, union

Левая	Сложение
-	8	Левая	Вычитание
::

8

...

Левая

...

Конкатенация строк
<	7

...

–

...

Меньше чем
<=	7

...

–	Меньше или равно
>	7

...

–

...

Больше чем
>=	7

...

–	Больше или равно
==	6

...

–

...

Равно
!=	6

...

–

...

Не равно
&	5

...

Левая

...

Побитовое И
^	4

...

Левая	Побитовое исключающее ИЛИ
\|	3

...

Левая

...

Побитовое ИЛИ
&&	2

...

Левая

...

Логическое И
\|\|	1

...

Левая

...

Логическое ИЛИ
=	0

...

Правая

...

Присваивание
+=	0

...

Правая	Сложение с присваиванием
-=	0	Правая	Разность с присваиванием
::

...

=

0

...

Правая	Конкатенация с присваиванием
*=	0

...

Правая

Умножение с присваиванием

...


/=	0

...

Правая

Деление с присваиванием

...


\=	0

...

Правая	Целочисленное деление с присваиванием
%=	0

...

Правая	Остаток от деления с присваиванием
**=	0

...

Правая

Возведение в степень с присваиванием

...


&=	0

...

Правая	Бинарное И с присваиванием
^=	0

...

Правая	Бинарное исключающее И с присваиванием
\|=	0

...

Правая

Бинарное ИЛИ с присваиванием

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

...

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

...

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

...

число (см. ниже).

...

Пример

...

Результат
+$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, и наоборот
$a & $b

...

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

$a | $b

...

Устанавливает те биты, которые установлены в $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:

...


NIL	nil	0

...

Логический

true

1

...

Логический

false

0

...

Строка

""

0

...

Строка

"123.5"

123.5

...

Строка

"abc"

...

ошибка

...

Объект

...

любой

...

ошибка

Logical operations

...

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

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

Пример	Результат
!$a	true

...

, если $a

...

равно false,

...

и false в противном случае
$a && $b	true

...

, если $a

...

и $b

...

true, false в противном случае
$a \|\| $b	false,

...

если $a

...

и $b

...

false,

...

true

...

в противном случае

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

Тип	Значение	Результат

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

...


NIL	nil	false

...

Число

0

false

...

Число

Любое ненулевое

...

true

...

Строка

""

false

...

Строка

Любая непустая

true

...

Объект

...

Любой

true

Operations with strings

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

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

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

Пример	Результат

...


"a"

...

:: "b"

"ab"

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:

...

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

Тип	Значение	Результат

...


NIL	nil	""

...

Число

123.45

"123.45"

...

Логический

true

"true"

...

Логический

false

"false"

...

Объект

...

Любой

Сериализация в строку

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

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

Пример	Результат

Comparison operations

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

...


$a == $b	true

...

, если $a тождественно равно $b
$a != $b	true

...

, если $a тождественно не равно $b
$a > $b	true

...

, если $a больше $b

$a >= $b

...

true,если $a больше или равно $b

$a < $b

...

true,если $a меньше $b

$a <= $b

...

true,если $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)	(1, 2, 3, 4)
['a', 'b'] + ['c']	['a', 'b', 'c']
{'a': 0, 'b': 2} + {'a': 1, 'c': 3}	{'a': 1, 'b': 2, 'c': 3}

Assignment operations

Assignment operators allow to assign a value to variable.

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

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

Пример	Результат

...


$a = 123	$a

...

содержит 123
$a += 1	$a = $a + 1
$a -= 1	$a = $a - 1
$a ::= "b"	$a = $a :: "b"
$a *= 2	$a = $a * 2
$a /= 2	$a = $a / 2
$a \= 2	$a = $a \ 2
$a %= 5	$a = $a % 5
$a **= 3	$a = $a ** 3
$a &= 1	$a = $a & 1
$a \|= 3	$a = $a \| 3
$a ^= 4	$a = $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.

text

Блок кода

language	php
theme	DJango
firstline	1
title	Пример использования
linenumbers	true

Блок кода

language

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

/ Returns a random number in the range from

/ Получаем случайное число от 5

to

до 10. math

-

–

module

название

name

модуля, rand

-

–

function

название

nameLike object methods function names can be dynamically calculated during the execution of the bot script

функции

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

...

text

Блок кода

language

	php
theme	DJango
firstline	1
title	Пример использования
linenumbers	true

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

Returns

Получаем

a random number in the range from

случайное число 0

to 1 that will be the index of the function name in the tuple

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

Returns

Получаем

the

название

name of

функции

the

min

or

или max

function

и

and

далее

then

вызываем

calls it

её.

This

Таким

way

образом,

we

мы

calculate

вычисляем

either

случайным

the

образом

minimum

либо

or

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

maximum

либо

value on the random basis

...

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

Быстрые ссылки

Дерево страниц

История страницы

Сравнение версий

Старая версия 70

Новая версия Текущий

Ключ

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

Комментарии

Переменные

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

Типы данных

Числа

Строки

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

Объекты

Кортежи

Списки

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

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

Операции

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

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

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

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

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

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

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

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

Функции

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

Комментарии

Переменные

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

Типы данных

Числа

Строки

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

Объекты

Structure of operations

Comments

Variables

Variable variables

Data types

Numbers

Strings

Кортежи

Списки

Boolean (logical) values

Objects

Tuples

Lists

Associative arrays (dictionaries)

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

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

Special value nil

Operations

Priorities of operations

Операции

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

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

Bitwise operations

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

Logical operations

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

Operations with strings

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

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

Comparison operations

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

Operations with collections

Assignment operations

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

Функции

Functions