QuData - User contributions [en]

Qubot Script/ru

2022-09-12T10:22:04Z

Mkuznetsov:

{{TOCright}}
== Qubot Script ==

'''''Qubot Script''''' - это язык программирования, используемый для выполнения логических и математических операций при решении задач бота


== Слоты ==

'''Слот''' - это переменная, значение которой доступно во всех состояниях бота. Также значение слота сохраняется, если бота закрыли и продолжили
с ним работать через время.

Объявление слота происходит при первом присваивании в него значений. Например:

<syntaxhighlight lang="js">
a = 7
</syntaxhighlight>
объявляет слот с именем '''a''' и присваивает ему значение '''7'''



== Локальные переменные ==

В отличие от слотов локальные переменные сохраняются только внутри скрипта, где они объявлены. 
Объявление происходит путем добавления перед именем служебного слова '''local''':
<syntaxhighlight lang="js">
local b = 8 // локальная переменная
</syntaxhighlight>

Если локальная переменная объявлена внутри фигурных скобок '''{}''', то и ее значение доступно только там:

<syntaxhighlight lang="js">
local b = 8 // локальная переменная текущего скрипта

if (b == 8)
{
local c = 9 // локальная переменная блока оператора 'if'
print(c) // выведет 9
}

print(b) // выведет 8
print(c) // выдаст ошибку, т.к. тут уже переменная 'с' недоступна
</syntaxhighlight>



== Типы переменных ==

<syntaxhighlight lang="js">
sInt = 7 // целочисленный
sFloat = 7.3 // вещественный
sStr = "hello" // строковый
sArr = [7, 7.3, "hello", sStr] // массив
sDic = { n: 1, s: "Wine" } // словарь
sBool = true // бинарный
sRegExp = /[abc]/ // регулярное выражение
sNone = none // неопределенное значение
</syntaxhighlight>



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

* '''and''' - логическое ‘И’
* '''or''' - логическое ‘ИЛИ’
* '''not''' - отрицание ‘НЕТ’

Например:

<syntaxhighlight lang="vb">
a = true
b = false
c = true
res = not((a and b) or c)
</syntaxhighlight>



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

* '''+''' - сложение
* '''-''' - вычитание
* '''*''' - умножение
* '''/''' - деление

Например:

<syntaxhighlight lang="js">res = 2+3-4*5+(1.5-0.2/2)</syntaxhighlight>

== Комментарии ==

Комментарии используются для документирования фрагментов скрипта.
Могут быть многострочыми и однострочными:
<syntaxhighlight lang="js">
/*
Пример
многострочного
комментария
*/

a = 2253 // пример однострочного комментария

</syntaxhighlight>

Также разрешается и питоновский стиль комментария:
<syntaxhighlight lang="python">
a = 2253 # пример однострочного комментария
</syntaxhighlight>





== Работа со словарем (объектом) ==

Объявление словаря:

<syntaxhighlight lang="js">dic = { n: 1, s: "Wine" } </syntaxhighlight>

Доступ к значениям словаря:

<syntaxhighlight lang="js">a = dic.n // доступ к полю с именем "n" через точку
a = dic["n"] // доступ к полю с именем "n" через оператор доступа
dic["food"] = "milk" // добавление в словарь пары ключ-значение
</syntaxhighlight>

== Работа с массивами ==

Объявление массива:

<syntaxhighlight lang="js">
arr = [1,2,3] // создает массив с тремя элементами со значениями 1,2,3

</syntaxhighlight>

Доступ к элементам массива:

<syntaxhighlight lang="js">first = arr[0] // получить первый элемент массива
last = arr[-1] // получить последний элемент массива
last = arr[-2] // получить предпоследний элемент массива
arr[0] = 7 // изменить значение первого элемента</syntaxhighlight>
Функции работы с массивом:

'''''push(val1,val2...)''''' - добавить в конец массива элементы со значениями '''val1, val2...'''
<syntaxhighlight lang="js">
arr.push(4) // добавить значение '4' в конец массива
</syntaxhighlight>

'''''unshift(val1,val2...)''''' - добавить в начало массива элементы со значениями '''val1, val2...'''
<syntaxhighlight lang="js">
arr.unshift(0) // добавить значение '0' в начало
</syntaxhighlight>

'''''pop()''''' - удалить последний элемент массива и вернуть его значение

'''''shift()''''' - удалить первый элемент массива и вернуть его значение

'''''slice(start,end)''''' - возвращает часть массива начиная с позиции '''start''' и если указана переменная '''end''', то до нее не включая

'''''splice(start, deleteCount)''''' - удаляет '''deleteCount''' элементов начиная с позиции '''start'''

'''''clear()''''' - очистить массив

Функции работы с массивом словарей:

'''''find(EXPR)''''' - ищет элементы массива, удовлетворяющие условию '''EXPR'''. Найденные элементы возвращаются в виде массива 
Например:
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120},
{title: "Cheese", price: 100},
{title: "Cola", price: 40},
]

local res = arr.find(price > 80) // найти все объекты у которых поле 'price' больше 80 и вернуть их в массиве
print('найдено $res.length:') // выведет количество найденных объектов
print(res) // выведет объекты, удовлетворяющие условию
</syntaxhighlight>

'''''total(EXPR)''''' - применить выражение '''EXPR''' к каждому элементу массива и суммировать все значения 
Например посчитаем сумму товаров в корзине:
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
{title: "Cola", price: 40, amount: 3},
]

local res = arr.total(price * amount) // для каждого элемента массива умножаем цену на количество и складываем результат
print("К оплате: $res грн.") // выведет сумму товаров: "К оплате: 680 грн."
</syntaxhighlight>

'''''count(EXPR)''''' - найти количество элементов массива для которых истинно выражение '''EXPR'''
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
{title: "Cola", price: 40, amount: 3},
]

local res = arr.count(price < 100) // для каждого элемента массива умножаем цену на количество и складываем результат
print("Количество товаров, дешевле 100 грн: $res") // выведет количество товаров: "Количество товаров, дешевле 100 грн: 1"
</syntaxhighlight>

'''''sort(KEY)''''' - отсортировать массив

Поддерживаются только массивы, в которых все значения одного типа: число или строка для sort() и словарь для sort(key)

<syntaxhighlight lang="js">
list = [1, 3, 2] // массив чисел
str = ["a", "hi", "banana"] // массив строк
arr = [ // массив из словарей с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
]

list.sort() // отсортировать массив по возрастанию
str.sort() // отсортировать массив по возрастанию
arr.sort(price) // отсортировать массив объектов по ключу 'price'
// TODO
</syntaxhighlight>

'''''reverse()''''' - перевернуть массив
<syntaxhighlight lang="js">
list = [1, 3, 2] // массив

list.reverse() // [2, 3, 1]
</syntaxhighlight>



== Работа со строками ==

Объявление строковых слотов:

<syntaxhighlight lang="js">
str = "hello" // используя двойные кавычки
str = 'hello' // используя одинарные кавычки</syntaxhighlight>

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

<syntaxhighlight lang="js">
base = 'http://imgs/'
url = base + 'img1.png' // сложение строк
</syntaxhighlight>


Подстановка слотов в строки:
<syntaxhighlight lang="js">
a = 5
str = "a = $a" // вместо $a будет подставлено значение слота a
print(str) // выведет: "a = 5"
</syntaxhighlight>

Вставка выражений в строки:

Выражения можно вставлять в строки, обрамляя их фигурными скобками:
<syntaxhighlight lang="js">
str = "2 + 3 = {2+3}" // вычислит выражение и вставит результат в строку
print(str) // выведет: "2 + 3 = 5"
</syntaxhighlight>

Экранирование спецсимволов '$','{','}' происходит путем добавления наклонной черты '\'
<syntaxhighlight lang="js">
str = "price: 4.99\$ \{sale\}" // вычислит выражение и вставит результат в строку
print(str) // выведет: "price: 4.99$ {sale}"
</syntaxhighlight>

Функции работы со строками:

'''''length''''' - получить длинну строки
<syntaxhighlight lang="js">
str = "hello"
len = str.length // вернет 5 - число символов строки "hello"
</syntaxhighlight>

'''''substring(start,end)''''' - получить подстроку начиная с позиции '''start''' и до позиции '''end''' не включая
<syntaxhighlight lang="js">
str = "http://server/im.png"
substr = str.substring(7,13) // вернет строку "server"
</syntaxhighlight>

'''''search(pattern)''''' - найти позицию первого вхождения '''pattern''', иначе вернуть -1. Аргумент '''pattern''' может быть как строкой
так и регулярным выражением:

<syntaxhighlight lang="js">
str = "apple orange juice"
res = str.search('orange') // вернет позицию строки 'orange': 6
res = str.search(/(orange|juice)/) // вернет позицию строки 'orange' или 'juice'
res = str.search('pizza') // не найдет 'pizza' и вернет -1
</syntaxhighlight>



== Условный оператор ==
Оператор '''if''' используется, если необходимо ветвление логики в зависимости от условия

<syntaxhighlight lang="js">
a = 9
if (a > 7)
{
res = 'a more than 7'
}
else
{
res = 'a less or equal 7'
}</syntaxhighlight>
В данном примере проверяется условие <code>a > 7</code> и если оно истинно, то выполняется первый блок скрипта, окруженный фигурными скобками, иначе выполняется блок после служебного слова '''else'''



== Цикл '''while''' ==

Оператор цикла проверяет условие и пока оно истинно, выполняет код окруженный фигурными скобками

<syntaxhighlight lang="js">a = 7
while (a > 0)
{
a = a - 1
}</syntaxhighlight>
В данном примере скрипт <code>a = a - 1</code> будет выполнятся до тех пор пока значение слота <code>a</code> не станет равным нулю


== Итератор '''for''' ==

Итератор используется для перебора всех значений массива, либо ключей из словаря

<syntaxhighlight lang="js">
arr = [3,2,1]
for(val in arr)
{
print(val)
}
output:
3
2
1
</syntaxhighlight>
В данном примере цикл последовательно перебирает значения массива и заносит их во временную переменную '''val''' соответственно для каждого элемента массива выполняется окруженный фигурными скобками скрипт '''print(val)''' выводящий значение в отладочное окно

Иногда удобно в цикле иметь и индекс массива, для этого перед переменной значения добавляем имя переменной индекса:

<syntaxhighlight lang="js">
arr = [3,2,1]
for(i, val in arr)
{
print("$i: $val")
}
output:
0: 3
1: 2
2: 1
</syntaxhighlight>

Для перебора ключей и значений словаря используется аналогичная конструкция:
<syntaxhighlight lang="js">
arr = {pizza: 100, milk: 20, wine: 120}
for(key, val in arr)
{
print("$key: $val")
}
output:
pizza: 100
milk: 20
wine: 120
</syntaxhighlight>



== Оператор выбора '''switch''' ==

Конструкция '''switch''' заменяет собой сразу несколько '''if'''. Она представляет собой более наглядный способ сравнить выражение сразу с несколькими вариантами.
Имеет один или более блок '''case''' и необязательный блок '''default'''.

<syntaxhighlight lang="js">
a = 'one'
switch(a)
{
case 'one': print('one'); break;
case 'two': print('two'); break;
default: print('def')
}
</syntaxhighlight>

Переменная проверяется на строгое соответствие значению справа от '''case''' и если оно совпадает, то выполняется код до тех пор пока не встретится
оператор '''break'''

Если ни одно из '''case''' не подошло, выполняется код справа от '''default'''



== Оператор '''in''' ==

Оператор '''in''' проверяет есть ли значение в массиве либо является ключём в словаре.

<syntaxhighlight lang="js">
sArr = [7, 7.3, "hello"] // массив
print("hello" in sArr) // вернет true, т.к. значение "hello" присутствует в массиве sArr
sDic = { price: 100, food: "Wine"} // словарь
print("food" in sDic) // вернет true, т.к. ключ "food" присутствует в словаре sDic

</syntaxhighlight>

Переменная проверяется на строгое соответствие значению справа от '''case''' и если оно совпадает, то выполняется код до тех пор пока не встретится
оператор '''break'''

Если ни одно из '''case''' не подошло, выполняется код справа от '''default'''



== Оператор '''button''' ==

'''''button(caption){ SCRIPT }''''' 
Данный оператор добавляет в интерфейс кнопку с текстом '''caption''' в текущее сообщение. После нажатия на кнопку выполняется логика '''SCRIPT'''.
Если '''caption''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.

<syntaxhighlight lang="js">
button('click me') // текст в кнопке
{
// скрипт, который выполнится после нажатия
print('button was clicked!')
step('STATE_AFTER_CLICK')
}
</syntaxhighlight>

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



== Функции перехода ==

'''''run(state)''''' - выполнить логику шага '''state'''

'''''step(state)''''' - установка шага перехода по умолчанию в значение '''state'''

'''''goto(state)''''' - мгновенный переход в шаг '''state'''



== Функции работы с контентом ==

'''''text(obj)''''' - вывести в текущее сообщение текст. Если '''obj''' - это строка, то она выводится независимо от текущего языка. Если '''obj''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.

<syntaxhighlight lang="js">
text("Hi world!")
text({ en: "Hi world!", ru: "Привет мир!", es: "¡Hola mundo!"})
</syntaxhighlight>

'''''images()''''' - создать новую строку картинок. Каждый последующий вызов image будет добавляться в эту строку, пока снова не будет вызван images().

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
images()
image(URL + "owl_a.png")
image(URL + "owl_b.png") </syntaxhighlight>

'''''image(url, width)''''' - вывести в текущее сообщение картинку. Если '''url''' - это строка, то он используется не зависимо от текущего языка. Если '''url''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.. Необязательный параметр '''width''' указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.png")
image({ en: URL + "en.png", ru: URL + "ru.png"})
</syntaxhighlight>

'''''buttons()''''' - создать новую строку кнопок. Каждый последующий вызов button будет добавляться в эту строку, пока снова не будет вызван buttons().

'''''get_check()''''' - получить массив значений кнопок типа check (1 - нажата, 0 - отжата)

'''''set_check(list)''''' - задать значения кнопок типа check из массива list.

<syntaxhighlight lang="js">
CHECK = [0,1,0]
set_check(CHECK)
</syntaxhighlight>

'''''get_radio()''''' - получить массив значений кнопок типа radio (1 - нажата, 0 - отжата). Единица будет одна.

'''''set_radio(list)''''' - задать значения кнопок типа radio из массива list.



== Отладочные функции ==

'''''print(args)''''' - вывод информации в окно отладки



== Округление ==

'''''floor(val)''''' - округление чисел в меньшую сторону:

<syntaxhighlight lang="js">floor(5.8) // 5
floor(-6.1) // -7</syntaxhighlight>
'''''trunc(val)''''' - отбрасывание дробной части:

<syntaxhighlight lang="js">trunc(5.51) // 5
trunc(-6.99) // -6</syntaxhighlight>
'''''ceil(val)''''' - округление чисел в большую сторону:

<syntaxhighlight lang="js">ceil(5.15) // 6</syntaxhighlight>
'''''round(val, num)''''' - округление '''val''' до '''num''' чисел после запятой:

<syntaxhighlight lang="js">round(3.14159265, 2) // 3.14</syntaxhighlight>


== Случайные числа ==

'''''randint(min,max)''''' - возвращает целое случайное число в диапазоне [min,max].

'''''random()''''' - возвращает случайное вещественное число в диапазоне [0,1].


== Дата и время ==

'''''date(format)''''' - возвращает текущую дату и время в указанном формате. По умолчанию аргумент '''format''' принимает значение: '''%d/%m/%Y %H:%M:%S'''

Поддерживаемые коды форматирования:

* '''%y''' - год без столетия ('22')
* '''%Y''' - год ('2022')
* '''%m''' - месяц
* '''%d''' - день
* '''%H''' - часы
* '''%M''' - минуты
* '''%S''' - секунды

Например:
<syntaxhighlight lang="js">
date() // 17/05/2022 18:16:31 т.е. сейчас
date('%Y.%m.%d %H:%M:%S') // 2022.05.17 18:16:31
</syntaxhighlight>


== Сохранение данных ==

'''''save(storage, params...)''''' - сохранить данные в таблицу.

Где params - это:
* '''для QuData.com, WordPress:'''
** data - данные для сохранения

* '''для Google Sheets:'''
** data - данные для сохранения
** link - ссылка на гугл таблицу
** filter - фильтр для изменения данных. По умолчанию равен null.

Например:
<syntaxhighlight lang="js">
save('qudata', {field: 'val'})
save('google_sheets', {field: 'val'}, 'https://....com')
save('google_sheets', {field: 'val'}, 'https://....com', {'name':'Dmitry'})
</syntaxhighlight>


== Загрузка данных ==

'''''load(storage, params...)''''' - загрузить данные из таблицы.
''Для загрузки файлов поддерживаются форматы .yml и .csv(с разделителем ;(точка с запятой))''

Где params - это:
* '''для Google Sheets:'''
** link - ссылка на гугл таблицу
** filter - фильтр для выборки данных. По умолчанию равен null.

* '''для Google Drive:'''
** link - ссылка на файл

* '''для Dropbox:''' - ''Должен быть настроен канал!''
** path - путь к файлу на dropbox

Например:
<syntaxhighlight lang="js">
result = load('google_sheets', 'https://....com')
result = load('google_sheets', 'https://....com', {'name':'Dmitry'})
result = load('google_drive', 'https://....com')
result = load('dropbox', '/folder_name/file_name.yml')
</syntaxhighlight>


== Подключение к оператору ==

'''''operator(service, params...)''''' - работа с онлайн чатом.

Где params - это:
* '''для LiveChat'''
** state - состояние чата (start - отправить первое сообщение, wait - начать общение, close - закрыть)
** name - имя клиента. Только для состояния state.
** message - сообщение. Только для состояния state.

Например:
<syntaxhighlight lang="js">
operator('livechat', 'start', 'Adam', 'Hi, operator!')
operator('livechat', 'wait')
operator('livechat', 'close')
</syntaxhighlight>


== Отправить событие ==

'''''event(name, target)''''' - Отправить в аналитику событие. Где:
* name - название события.
* target - является ли событие важным. По умолчанию false.

Например:
<syntaxhighlight lang="js">
event('test')
event('test', true)
</syntaxhighlight>

[[Category:Qubot]]
[[Category:ru]]

Qubot Script/ru

2022-09-12T08:54:49Z

Mkuznetsov:

Qubot Google Sheets Setup/ru

2022-08-09T13:54:44Z

Mkuznetsov:

{{TOCright}}
== Подключение Google таблиц к боту ==

Подключив электронные таблицы Google, вы значительно улучшите работу с ботом. Например,
ваш бот сможет загружать данные прямо из вашей электронной таблицы Google, а также загружать новые данные в режиме реального времени.
Использование Google таблиц значительно облегчит вашу работу, поскольку вы будете иметь прямой доступ к чтению и редактированию сохраненных данных в любое время,
не вмешиваясь в код бота.

Для подключения таблиц следуйте шагам описанным ниже:
== Шаг 1 ==

Войдите или же создайте аккаунт на https://accounts.google.com
 
 
[[File:GoogleSheets1.png|500px]]
 
 

== Шаг 2 ==

Откройте свои Google таблицы здесь https://docs.google.com/spreadsheets

Вы также можете получить доступ к своим таблицам Google с главной страницы Google, нажав кнопку приложений Google.
 
 
[[File:GoogleSheets2.png|500px]] [[File:GoogleSheets3.png|500px]]
 

== Шаг 3 ==

Поделитесь Google таблицей с ботом:

В Google таблицах откройте электронную таблицу и нажмите кнопку Share(Поделиться).
 
 
[[File:GoogleSheets4.png|500px]]
 
 
Предоставьте доступ любым из возможных способов.
Первый способ. Поделиться с определенной учетной записью: скопируйте следующую учетную запись в поле ввода окна обмена и отправьте приглашение.

'''qudata-bot-service@qudata-services.iam.gserviceaccount.com'''
 
 
[[File:GoogleSheets5.png|500px]]
 
 
Второй способ. Ссылка для общего доступа: в разделе Get link(Получить ссылку) измените статус Restricted(ограниченный доступ) на Anyone with the link(все, у кого есть ссылка), и нажать Готово.
 
 
[[File:GoogleSheets6.png|500px]]
 
 
Обратите внимание, что вы можете контролировать доступ: если бот будет считывать данные только из таблицы Google,
то достаточно роли Viewer, а если бот еще и сохраняет данные в таблицу Google, то требуется роль Editor.
Вы можете изменить роль в любое время в настройках общего доступа.

== Шаг 4 ==

Настройте загрузку данных в таблицу в редакторе бота. Дополнительную информацию об этом можно
найти в шаблонах редактора ботов (например, Trivia, шаблоны Order Food) или в нашем справочном центре.

== Настройка работы с данными Google таблиц в боте ==

Выберите нужного вам бота. Зайдите в Editor(Редактор) бота.

'''Загрузка данных с таблицы'''

1. Выберите нужный шаг в вашем боте где нужно загрузить данные с google таблицы(К примеру Main).
 
 
[[File:EditorGoogleSheet1.png|250px]]
 
 
2. Выберите/создайте элемент, действием которого должна быть загрузка данных с таблицы. Это может быть Buttons(кнопка), элемент Actions(действие), просто ввод любого текста пользователем(click to show actions when) и другие элементы.
 
 
[[File:EditorGoogleSheet2.png|250px]] [[File:EditorGoogleSheet3.png|250px]]
 
3. В поле Item properties у вас появится возможность добавить свойство:
 
 
[[File:EditorGoogleSheet4.png|250px]] [[File:EditorGoogleSheet5.png|250px]]
 
4. Выберите свойство load:
 
 
[[File:EditorGoogleSheet6.png|250px]]
 
 
5. В свойстве load выберите из списка Google Sheets
 
 
[[File:EditorGoogleSheet7.png|250px]]
 
 
6. В поле Google Sheets table url введите url(ссылку) вашей google таблицы
 
 
[[File:EditorGoogleSheet8.png|700px]]
 
 
[[File:EditorGoogleSheet9.png|400px]]
 
7. В поле Slot name введите имя переменной, в которой будут хранится данные с вашей таблицы в виде массива объектов:
 
 
[[File:EditorGoogleSheet10.png|250px]]
 
 
Используйте эту переменную для работы с вашими данными.

'''''Убедитесь, что вы дали доступ на чтение или редактирование своей таблицы'''''

'''Запись данных в таблицу'''

Пройдите шаги 1-3 описанных выше в "Загрузка данных с таблицы" выбрав шаг на котором нужно сделать запись в таблицу.

4. Выберите свойство save:
 
 
[[File:EditorGoogleSheet11.png|250px]]
 
 
5. В свойстве save выберите из списка Google Sheets
 
 
[[File:EditorGoogleSheet12.png|250px]]
 
 
6. В поле Google Sheets table url введите url(ссылку) вашей google таблицы
 
 
[[File:EditorGoogleSheet8.png|700px]]
 
 
[[File:EditorGoogleSheet13.png|400px]]
 
7. В поле Data value введите данные, которые будут записаны в таблицу в указанном формате в виде объекта:
 
[[File:EditorGoogleSheet14.png|250px]] [[File:EditorGoogleSheet15.png|250px]]
 
'''''Убедитесь, что вы дали доступ на редактирование своей таблицы'''''

== Работа с фильтрами ==

В боте можно получать выборочные данные или изменять существующие, для этого используются фильтры. 
Фильтры представляют собой словарь данных следующей структуры: { 'СТОЛБЕЦ': ДАННЫЕ, ... } 
В одном фильтре можно указывать несколько столбцов. 
Все столбцы в одном фильтре считаются как логическое "И", то есть, фильтр будет искать такие строки, у которых во всех указанных столбцах совпадают все указанные данные.

'''Выборочная загрузка данных с таблицы'''

1. Настройте вашего бота на загрузку данных согласно инструкции выше. 
2. Укажите в поле Data filter фильтр в виде словаря. 
[[File:GoogleSheets16.png|350px]] 
3. В словарь SLOT_DATA будут записаны только те данные, значения из столбцов которых соответствуют введённым. 

'''Изменение данных в таблице'''

1. Настройте вашего бота на сохранение данных согласно инструкции выше. 
2. Укажите в поле Data filter фильтр в виде словаря. 
[[File:GoogleSheets17.png|350px]] 
3. Данные из таблицы, которые соответствуют фильтру будут изменены. 
''Если фильтр не сработал, то данные записаны не будут''. 

'''''Убедитесь, что вы дали доступ на редактирование своей таблицы'''''
[[Category:Qubot]]

Qubot Google Sheets Setup/ru

2022-08-09T13:53:51Z

Mkuznetsov:

{{TOCright}}
== Подключение Google таблиц к боту ==

Подключив электронные таблицы Google, вы значительно улучшите работу с ботом. Например,
ваш бот сможет загружать данные прямо из вашей электронной таблицы Google, а также загружать новые данные в режиме реального времени.
Использование Google таблиц значительно облегчит вашу работу, поскольку вы будете иметь прямой доступ к чтению и редактированию сохраненных данных в любое время,
не вмешиваясь в код бота.

Для подключения таблиц следуйте шагам описанным ниже:
== Шаг 1 ==

Войдите или же создайте аккаунт на https://accounts.google.com
 
 
[[File:GoogleSheets1.png|500px]]
 
 

== Шаг 2 ==

Откройте свои Google таблицы здесь https://docs.google.com/spreadsheets

Вы также можете получить доступ к своим таблицам Google с главной страницы Google, нажав кнопку приложений Google.
 
 
[[File:GoogleSheets2.png|500px]] [[File:GoogleSheets3.png|500px]]
 

== Шаг 3 ==

Поделитесь Google таблицей с ботом:

В Google таблицах откройте электронную таблицу и нажмите кнопку Share(Поделиться).
 
 
[[File:GoogleSheets4.png|500px]]
 
 
Предоставьте доступ любым из возможных способов.
Первый способ. Поделиться с определенной учетной записью: скопируйте следующую учетную запись в поле ввода окна обмена и отправьте приглашение.

'''qudata-bot-service@qudata-services.iam.gserviceaccount.com'''
 
 
[[File:GoogleSheets5.png|500px]]
 
 
Второй способ. Ссылка для общего доступа: в разделе Get link(Получить ссылку) измените статус Restricted(ограниченный доступ) на Anyone with the link(все, у кого есть ссылка), и нажать Готово.
 
 
[[File:GoogleSheets6.png|500px]]
 
 
Обратите внимание, что вы можете контролировать доступ: если бот будет считывать данные только из таблицы Google,
то достаточно роли Viewer, а если бот еще и сохраняет данные в таблицу Google, то требуется роль Editor.
Вы можете изменить роль в любое время в настройках общего доступа.

== Шаг 4 ==

Настройте загрузку данных в таблицу в редакторе бота. Дополнительную информацию об этом можно
найти в шаблонах редактора ботов (например, Trivia, шаблоны Order Food) или в нашем справочном центре.

== Настройка работы с данными Google таблиц в боте ==

Выберите нужного вам бота. Зайдите в Editor(Редактор) бота.

'''Загрузка данных с таблицы'''

1. Выберите нужный шаг в вашем боте где нужно загрузить данные с google таблицы(К примеру Main).
 
 
[[File:EditorGoogleSheet1.png|250px]]
 
 
2. Выберите/создайте элемент, действием которого должна быть загрузка данных с таблицы. Это может быть Buttons(кнопка), элемент Actions(действие), просто ввод любого текста пользователем(click to show actions when) и другие элементы.
 
 
[[File:EditorGoogleSheet2.png|250px]] [[File:EditorGoogleSheet3.png|250px]]
 
3. В поле Item properties у вас появится возможность добавить свойство:
 
 
[[File:EditorGoogleSheet4.png|250px]] [[File:EditorGoogleSheet5.png|250px]]
 
4. Выберите свойство load:
 
 
[[File:EditorGoogleSheet6.png|250px]]
 
 
5. В свойстве load выберите из списка Google Sheets
 
 
[[File:EditorGoogleSheet7.png|250px]]
 
 
6. В поле Google Sheets table url введите url(ссылку) вашей google таблицы
 
 
[[File:EditorGoogleSheet8.png|700px]]
 
 
[[File:EditorGoogleSheet9.png|400px]]
 
7. В поле Slot name введите имя переменной, в которой будут хранится данные с вашей таблицы в виде массива объектов:
 
 
[[File:EditorGoogleSheet10.png|250px]]
 
 
Используйте эту переменную для работы с вашими данными.

'''''Убедитесь, что вы дали доступ на чтение или редактирование своей таблицы'''''

'''Запись данных в таблицу'''

Пройдите шаги 1-3 описанных выше в "Загрузка данных с таблицы" выбрав шаг на котором нужно сделать запись в таблицу.

4. Выберите свойство save:
 
 
[[File:EditorGoogleSheet11.png|250px]]
 
 
5. В свойстве save выберите из списка Google Sheets
 
 
[[File:EditorGoogleSheet12.png|250px]]
 
 
6. В поле Google Sheets table url введите url(ссылку) вашей google таблицы
 
 
[[File:EditorGoogleSheet8.png|700px]]
 
 
[[File:EditorGoogleSheet13.png|400px]]
 
7. В поле Data value введите данные, которые будут записаны в таблицу в указанном формате в виде объекта:
 
[[File:EditorGoogleSheet14.png|250px]] [[File:EditorGoogleSheet15.png|250px]]
 
'''''Убедитесь, что вы дали доступ на редактирование своей таблицы'''''

== Работа с фильтрами ==

В боте можно получать выборочные данные или изменять существующие, для этого используются фильтры. 
Фильтры представляют собой словарь данных следующей структуры: { 'СТОЛБЕЦ': ДАННЫЕ, ... } 
В одном фильтре можно указывать несколько столбцов. 
Все столбцы в одном фильтре считаются как логическое "И", то есть, фильтр будет искать такие строки, у которых во всех указанных столбцах совпадают все указанные данные.

'''Выборочная загрузка данных с таблицы'''

1. Настройте вашего бота на загрузку данных согласно инструкции выше. 
2. Укажите в поле Data filter фильтр в виде словаря. 
[[File:GoogleSheets16.png]] 
3. В словарь SLOT_DATA будут записаны только те данные, значения из столбцов которых соответствуют введённым. 

'''Изменение данных в таблице'''

1. Настройте вашего бота на сохранение данных согласно инструкции выше. 
2. Укажите в поле Data filter фильтр в виде словаря. 
[[File:GoogleSheets17.png]] 
3. Данные из таблицы, которые соответствуют фильтру будут изменены. 
''Если фильтр не сработал, то данные записаны не будут''. 

'''''Убедитесь, что вы дали доступ на редактирование своей таблицы'''''
[[Category:Qubot]]

File:GoogleSheets17.png

2022-08-09T13:52:27Z

Mkuznetsov:

File:GoogleSheets16.png

2022-08-09T13:52:11Z

Mkuznetsov:

Qubot Google Sheets Setup/ru

2022-08-09T13:51:28Z

Mkuznetsov:

{{TOCright}}
== Подключение Google таблиц к боту ==

Подключив электронные таблицы Google, вы значительно улучшите работу с ботом. Например,
ваш бот сможет загружать данные прямо из вашей электронной таблицы Google, а также загружать новые данные в режиме реального времени.
Использование Google таблиц значительно облегчит вашу работу, поскольку вы будете иметь прямой доступ к чтению и редактированию сохраненных данных в любое время,
не вмешиваясь в код бота.

Для подключения таблиц следуйте шагам описанным ниже:
== Шаг 1 ==

Войдите или же создайте аккаунт на https://accounts.google.com
 
 
[[File:GoogleSheets1.png|500px]]
 
 

== Шаг 2 ==

Откройте свои Google таблицы здесь https://docs.google.com/spreadsheets

Вы также можете получить доступ к своим таблицам Google с главной страницы Google, нажав кнопку приложений Google.
 
 
[[File:GoogleSheets2.png|500px]] [[File:GoogleSheets3.png|500px]]
 

== Шаг 3 ==

Поделитесь Google таблицей с ботом:

В Google таблицах откройте электронную таблицу и нажмите кнопку Share(Поделиться).
 
 
[[File:GoogleSheets4.png|500px]]
 
 
Предоставьте доступ любым из возможных способов.
Первый способ. Поделиться с определенной учетной записью: скопируйте следующую учетную запись в поле ввода окна обмена и отправьте приглашение.

'''qudata-bot-service@qudata-services.iam.gserviceaccount.com'''
 
 
[[File:GoogleSheets5.png|500px]]
 
 
Второй способ. Ссылка для общего доступа: в разделе Get link(Получить ссылку) измените статус Restricted(ограниченный доступ) на Anyone with the link(все, у кого есть ссылка), и нажать Готово.
 
 
[[File:GoogleSheets6.png|500px]]
 
 
Обратите внимание, что вы можете контролировать доступ: если бот будет считывать данные только из таблицы Google,
то достаточно роли Viewer, а если бот еще и сохраняет данные в таблицу Google, то требуется роль Editor.
Вы можете изменить роль в любое время в настройках общего доступа.

== Шаг 4 ==

Настройте загрузку данных в таблицу в редакторе бота. Дополнительную информацию об этом можно
найти в шаблонах редактора ботов (например, Trivia, шаблоны Order Food) или в нашем справочном центре.

== Настройка работы с данными Google таблиц в боте ==

Выберите нужного вам бота. Зайдите в Editor(Редактор) бота.

'''Загрузка данных с таблицы'''

1. Выберите нужный шаг в вашем боте где нужно загрузить данные с google таблицы(К примеру Main).
 
 
[[File:EditorGoogleSheet1.png|250px]]
 
 
2. Выберите/создайте элемент, действием которого должна быть загрузка данных с таблицы. Это может быть Buttons(кнопка), элемент Actions(действие), просто ввод любого текста пользователем(click to show actions when) и другие элементы.
 
 
[[File:EditorGoogleSheet2.png|250px]] [[File:EditorGoogleSheet3.png|250px]]
 
3. В поле Item properties у вас появится возможность добавить свойство:
 
 
[[File:EditorGoogleSheet4.png|250px]] [[File:EditorGoogleSheet5.png|250px]]
 
4. Выберите свойство load:
 
 
[[File:EditorGoogleSheet6.png|250px]]
 
 
5. В свойстве load выберите из списка Google Sheets
 
 
[[File:EditorGoogleSheet7.png|250px]]
 
 
6. В поле Google Sheets table url введите url(ссылку) вашей google таблицы
 
 
[[File:EditorGoogleSheet8.png|700px]]
 
 
[[File:EditorGoogleSheet9.png|400px]]
 
7. В поле Slot name введите имя переменной, в которой будут хранится данные с вашей таблицы в виде массива объектов:
 
 
[[File:EditorGoogleSheet10.png|250px]]
 
 
Используйте эту переменную для работы с вашими данными.

'''''Убедитесь, что вы дали доступ на чтение или редактирование своей таблицы'''''

'''Запись данных в таблицу'''

Пройдите шаги 1-3 описанных выше в "Загрузка данных с таблицы" выбрав шаг на котором нужно сделать запись в таблицу.

4. Выберите свойство save:
 
 
[[File:EditorGoogleSheet11.png|250px]]
 
 
5. В свойстве save выберите из списка Google Sheets
 
 
[[File:EditorGoogleSheet12.png|250px]]
 
 
6. В поле Google Sheets table url введите url(ссылку) вашей google таблицы
 
 
[[File:EditorGoogleSheet8.png|700px]]
 
 
[[File:EditorGoogleSheet13.png|400px]]
 
7. В поле Data value введите данные, которые будут записаны в таблицу в указанном формате в виде объекта:
 
[[File:EditorGoogleSheet14.png|250px]] [[File:EditorGoogleSheet15.png|250px]]
 
'''''Убедитесь, что вы дали доступ на редактирование своей таблицы'''''

== Работа с фильтрами ==

В боте можно получать выборочные данные или изменять существующие, для этого используются фильтры. 
Фильтры представляют собой словарь данных следующей структуры: { 'СТОЛБЕЦ': ДАННЫЕ, ... } 
В одном фильтре можно указывать несколько столбцов. 
Все столбцы в одном фильтре считаются как логическое "И", то есть, фильтр будет искать такие строки, у которых во всех указанных столбцах совпадают все указанные данные.

'''Выборочная загрузка данных с таблицы'''

1. Настройте вашего бота на загрузку данных согласно инструкции выше. 
2. Укажите в поле Data filter фильтр в виде словаря. 
[[File:EditorGoogleSheet16.png]] 
3. В словарь SLOT_DATA будут записаны только те данные, значения из столбцов которых соответствуют введённым. 

'''Изменение данных в таблице'''

1. Настройте вашего бота на сохранение данных согласно инструкции выше. 
2. Укажите в поле Data filter фильтр в виде словаря. 
[[File:EditorGoogleSheet17.png]] 
3. Данные из таблицы, которые соответствуют фильтру будут изменены. 
''Если фильтр не сработал, то данные записаны не будут''. 

'''''Убедитесь, что вы дали доступ на редактирование своей таблицы'''''
[[Category:Qubot]]

Qubot Google Sheets Setup/ru

2022-08-09T13:50:54Z

Mkuznetsov:

{{TOCright}}
== Подключение Google таблиц к боту ==

Подключив электронные таблицы Google, вы значительно улучшите работу с ботом. Например,
ваш бот сможет загружать данные прямо из вашей электронной таблицы Google, а также загружать новые данные в режиме реального времени.
Использование Google таблиц значительно облегчит вашу работу, поскольку вы будете иметь прямой доступ к чтению и редактированию сохраненных данных в любое время,
не вмешиваясь в код бота.

Для подключения таблиц следуйте шагам описанным ниже:
== Шаг 1 ==

Войдите или же создайте аккаунт на https://accounts.google.com
 
 
[[File:GoogleSheets1.png|500px]]
 
 

== Шаг 2 ==

Откройте свои Google таблицы здесь https://docs.google.com/spreadsheets

Вы также можете получить доступ к своим таблицам Google с главной страницы Google, нажав кнопку приложений Google.
 
 
[[File:GoogleSheets2.png|500px]] [[File:GoogleSheets3.png|500px]]
 

== Шаг 3 ==

Поделитесь Google таблицей с ботом:

В Google таблицах откройте электронную таблицу и нажмите кнопку Share(Поделиться).
 
 
[[File:GoogleSheets4.png|500px]]
 
 
Предоставьте доступ любым из возможных способов.
Первый способ. Поделиться с определенной учетной записью: скопируйте следующую учетную запись в поле ввода окна обмена и отправьте приглашение.

'''qudata-bot-service@qudata-services.iam.gserviceaccount.com'''
 
 
[[File:GoogleSheets5.png|500px]]
 
 
Второй способ. Ссылка для общего доступа: в разделе Get link(Получить ссылку) измените статус Restricted(ограниченный доступ) на Anyone with the link(все, у кого есть ссылка), и нажать Готово.
 
 
[[File:GoogleSheets6.png|500px]]
 
 
Обратите внимание, что вы можете контролировать доступ: если бот будет считывать данные только из таблицы Google,
то достаточно роли Viewer, а если бот еще и сохраняет данные в таблицу Google, то требуется роль Editor.
Вы можете изменить роль в любое время в настройках общего доступа.

== Шаг 4 ==

Настройте загрузку данных в таблицу в редакторе бота. Дополнительную информацию об этом можно
найти в шаблонах редактора ботов (например, Trivia, шаблоны Order Food) или в нашем справочном центре.

== Настройка работы с данными Google таблиц в боте ==

Выберите нужного вам бота. Зайдите в Editor(Редактор) бота.

'''Загрузка данных с таблицы'''

1. Выберите нужный шаг в вашем боте где нужно загрузить данные с google таблицы(К примеру Main).
 
 
[[File:EditorGoogleSheet1.png|250px]]
 
 
2. Выберите/создайте элемент, действием которого должна быть загрузка данных с таблицы. Это может быть Buttons(кнопка), элемент Actions(действие), просто ввод любого текста пользователем(click to show actions when) и другие элементы.
 
 
[[File:EditorGoogleSheet2.png|250px]] [[File:EditorGoogleSheet3.png|250px]]
 
3. В поле Item properties у вас появится возможность добавить свойство:
 
 
[[File:EditorGoogleSheet4.png|250px]] [[File:EditorGoogleSheet5.png|250px]]
 
4. Выберите свойство load:
 
 
[[File:EditorGoogleSheet6.png|250px]]
 
 
5. В свойстве load выберите из списка Google Sheets
 
 
[[File:EditorGoogleSheet7.png|250px]]
 
 
6. В поле Google Sheets table url введите url(ссылку) вашей google таблицы
 
 
[[File:EditorGoogleSheet8.png|700px]]
 
 
[[File:EditorGoogleSheet9.png|400px]]
 
7. В поле Slot name введите имя переменной, в которой будут хранится данные с вашей таблицы в виде массива объектов:
 
 
[[File:EditorGoogleSheet10.png|250px]]
 
 
Используйте эту переменную для работы с вашими данными.

'''''Убедитесь, что вы дали доступ на чтение или редактирование своей таблицы'''''

'''Запись данных в таблицу'''

Пройдите шаги 1-3 описанных выше в "Загрузка данных с таблицы" выбрав шаг на котором нужно сделать запись в таблицу.

4. Выберите свойство save:
 
 
[[File:EditorGoogleSheet11.png|250px]]
 
 
5. В свойстве save выберите из списка Google Sheets
 
 
[[File:EditorGoogleSheet12.png|250px]]
 
 
6. В поле Google Sheets table url введите url(ссылку) вашей google таблицы
 
 
[[File:EditorGoogleSheet8.png|700px]]
 
 
[[File:EditorGoogleSheet13.png|400px]]
 
7. В поле Data value введите данные, которые будут записаны в таблицу в указанном формате в виде объекта:
 
[[File:EditorGoogleSheet14.png|250px]] [[File:EditorGoogleSheet15.png|250px]]
 
'''''Убедитесь, что вы дали доступ на редактирование своей таблицы'''''

== Работа с фильтрами ==

В боте можно получать выборочные данные или изменять существующие, для этого используются фильтры. 
Фильтры представляют собой словарь данных следующей структуры: { 'СТОЛБЕЦ': ДАННЫЕ, ... } 
В одном фильтре можно указывать несколько столбцов. Все столбцы в одном фильтре считаются как логическое "И", то есть, фильтр будет искать такие строки, у которых во всех указанных столбцах совпадают все указанные данные.

'''Выборочная загрузка данных с таблицы'''

1. Настройте вашего бота на загрузку данных согласно инструкции выше. 
2. Укажите в поле Data filter фильтр в виде словаря. 
[[File:EditorGoogleSheet16.png]] 
3. В словарь SLOT_DATA будут записаны только те данные, значения из столбцов которых соответствуют введённым. 

'''Изменение данных в таблице'''

1. Настройте вашего бота на сохранение данных согласно инструкции выше. 
2. Укажите в поле Data filter фильтр в виде словаря. 
[[File:EditorGoogleSheet17.png]] 
3. Данные из таблицы, которые соответствуют фильтру будут изменены. 
''Если фильтр не сработал, то данные записаны не будут''. 

'''''Убедитесь, что вы дали доступ на редактирование своей таблицы'''''
[[Category:Qubot]]

Main Page

2022-07-05T07:47:44Z

Mkuznetsov:

QuBot is a set of tools for creating chatbots and virtual assistants.
----
;First steps:
* [[Principles of bot design]]
* [[Getting Started: Creating Your First Bot]]
; Setup and programming:
* [[Qubot Customizing]]
* [[Qubot Google Sheets Setup]]
* [[Qubot Script]]
* [[Qubot NLU|Creation of smart bots (NLP)]]
;[[:Category:Integrations|Integrations]]:
* [[Channels]]
* [[How to add a chatbot to your website]]
* [[How to integrate WordPress plugin to website|WordPress plugin]]
* [[Qubot Facebook Integration|Facebook ]]
* [[Qubot Telegram Integration|Telegram]]
* [[Qubot Viber Integration|Viber ]]
* [[Qubot LiveChat Integration|LiveChat]]
* [[Qubot Whatsapp Integration|Whatsapp]]
----
* [[FAQ]]

[[Category:Qubot|*]]

Main Page/ru

2022-07-05T07:43:26Z

Mkuznetsov:

{|
|
'''Lang:'''
|
[[Main Page|en]]
|}
QuBot - это набор инструментов по созданию чат-ботов и виртуальных помощников.
----
;Первые шаги:
* [[Getting Started: Creating Your First Bot/ru]]
; Настройка и программирование:
* [[Qubot Customizing/ru]]
* [[Qubot Google Sheets Setup/ru|Подключение Google таблиц к боту]]
* [[Qubot Script/ru]]
* [[Qubot NLU/ru|Создание умных ботов (NLP)]]
;[[:Category:Integrations|Интеграция]]:
* [[How to add a chatbot to your website/ru|Установка чат-бота на собственный сайт]]
* [[How to integrate WordPress plugin to website/ru|WordPress plugin]]
* [[Qubot Facebook Integration/ru|Facebook ]]
* [[Qubot Telegram Integration/ru|Telegram ]]
* [[Qubot Viber Integration/ru |Viber ]]
* [[Qubot LiveChat Integration/ru|LiveChat]]
* [[Qubot Whatsapp Integration/ru|Whatsapp]]
----
* [[FAQ|Список часто задаваемых вопросов и ответов]]

[[Category:Qubot|*]]
[[Category:ru]]

Qubot NLU/ru

2022-07-05T07:42:26Z

Mkuznetsov: Created page with "{| | '''Lang:''' | en |} {{TOCright}} ==Введение== Если Вы хотите чтобы Ваш бот отвечал со..."

{|
|
'''Lang:'''
|
[[Qubot_NLU|en]]
|}


{{TOCright}}

==Введение==
Если Вы хотите чтобы Ваш бот отвечал современным тенденциям и умел обрабатывать ввод естественного текста, тогда воспользуйтесь нашей инновационной технологией обработки естественного языка (NLP). Именно NLP позволяет Вашему боту понимать водимые сообщение от пользователя и формировать подходящие ответы. Хочет клиент “две пиццы Маргарита и колу” или “колу и чизкейк на двоих” бот поймёт и оформит правильный заказ.

==Общие сведения о работе NLP==
Суть работы NLP сводится к анализу основных составляющих любого предложения - '''сущностей''' и '''намерений'''.

*'''Сущности(entities)''' представляют собой любые объекты реального мира, например, кола (drink), Украина (country), 2022 (number), Дмитрий (name).

*'''Намерения(intents)''' - это желание клиента описанное в виде предложения, например, я хочу колу (want), как пройти к театру (finding a way), привет (greeting).

Для распознавания намерений используют методы машинного обучения на основе подготовленных фраз-примеров для каждого класса. Эти методы варьируются от простого мешка слов до нейронных сетей достаточно сложной архитектуры. В качестве признаков выступают слова, n-граммы слов, n-граммы букв (борьба с опечатками), наличие знака вопроса и т.д.

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

Ниже в таблице 1 представлено несколько простых примеров из бота пиццерии:

<table style="border-style: solid; border-width: 1px; border-color: lightgray;">
<tr><td>'''Сообщение 👩'''</td><td>'''Сущности'''</td><td>'''Намерение'''</td><td>'''Ответ 💻'''</td></tr>
<tr><td>Привет</td><td>-</td><td>greet</td><td>Здравствуйте</td></tr>
<tr><td>Привет, я Марго</td><td>$NAME = Маргарита</td><td>greet</td><td>Очень приятно, Маргарита!</td></tr>
<tr><td>Я хочу две Маргариты и колу</td><td>$NUMBER = 2 $NAME = Маргарита $DRINK = кола</td><td>want</td><td>Вам оформить заказ: 2 пиццы Маргарита и одна кола?</td></tr>
<tr><td>Я хочу</td><td>-</td><td>want</td><td>Что Вы хотите?</td></tr>
<tr><td>Я хочу в Украину</td><td>$COUNTRY = Украина</td><td>want</td><td>От Вас до Украины 4768.95 км. Удобнее всего Вам будет лететь на самолёте.</td></tr>
</table>

В каждом из представленных примеров бот, несмотря на схожие намерения и распознанные сущности бот дает осмысленные ответы. В случае намерения '''greet''', мы понимаем что $NAME - имя клиента, а в случае намерения '''want''' мы понимаем что $NAME название пиццы.

==Улучшение интеллектуального развития бота==
Описанные ранее общие сведения применяются для работы NLP у многих компаний, это довольно простая схема, только у неё есть недостаток - бот не способен ориентироваться в контексте. Это значит что во всех примерах из таблицы 1 всегда будет один и тот же ответ.

Для предоставления боту большего интеллекта в NLP от QuData используются '''забываемые намерения''', а также механизм сохраняющий историю общения с клиентом.

'''Забываемые намерения''' - это такие намерения, которые происходят вне основного направления бота и забываются при первом же обычном намерении.

Благодаря этому Вам бот может ориентироваться в контексте, а также обрабатывать более сложные цепочки диалогов, например, такие:

''Желтым выделены забываемые намерения.''

<table style="border-style: solid; border-width: 1px; border-color: lightgray;">
<tr><td>'''Сообщение 👩'''</td><td>'''Сущности'''</td><td>'''Намерение'''</td><td>'''Ответ 💻'''</td></tr>
<tr><td>Хочу фанту</td><td>$DRINKS = фанта</td><td>want</td><td>Сколько фанты Вы хотите?</td></tr>
<tr style="background-color: lightyellow"><td>А сколько она стоит?</td><td>-</td><td>[ want, what-is-the-price ]</td><td>Фанта стоит 20 гривен.</td></tr>
<tr><td>Тогда три</td><td>$NUMBER = 3</td><td>[ want, number ]</td><td>Я добавила в заказ 3 фанты</td></tr>
</table>

<table style="border-style: solid; border-width: 1px; border-color: lightgray;">
<tr><td>'''Сообщение 👩'''</td><td>'''Сущности'''</td><td>'''Намерение'''</td><td>'''Ответ 💻'''</td></tr>
<tr><td>/start</td><td>-</td><td>start</td><td>Здравствуйте. Меня зовут Бот. Как Вас зовут?</td></tr>
<tr><td>Меня зовут Катя</td><td>$NAME = Екатерина</td><td>[start, my name is]</td><td>Очень приятно Екатерина, рад знакомству.</td></tr>
<tr style="background-color: lightyellow"><td>Привет</td><td>-</td><td>greet</td><td>Всегда рад поздороваться повторно.</td></tr>
<tr style="background-color: lightyellow"><td>Meня зовут Маша</td><td>$NAME = Мария</td><td>my name is</td><td>Понятно... То есть Вас зовут Мария?</td></tr>
<tr style="background-color: lightyellow"><td>Нет.</td><td>-</td><td>deny</td><td>Как же Вас тогда зовут?</td></tr>
<tr style="background-color: lightyellow"><td>Даша</td><td>$NAME = Дарья</td><td>name</td><td>Понятно... То есть Вас зовут Дарья?</td></tr>
<tr style="background-color: lightyellow"><td>Да</td><td>-</td><td>yes</td><td>Хорошо, Дарья, я это запомню.</td></tr>
<tr style="background-color: lightyellow"><td>Meня зовут Даша</td><td>$NAME = Дарья</td><td>my name is</td><td>Да, Дарья, я знаю.</td></tr>
<tr><td>Я хочу фанту</td><td>$DRINKS = фанта</td><td>want</td><td>Сколько фанты Вы хотите?</td></tr>
</table>

[[Category:Qubot]]
[[Category:ru]]

File:Test.jpg

2022-06-03T13:27:29Z

Mkuznetsov:

Qubot Script/ru

2022-05-27T08:35:32Z

Mkuznetsov:

{{TOCright}}
== Qubot Script ==

'''''Qubot Script''''' - это язык программирования, используемый для выполнения логических и математических операций при решении задач бота


== Слоты ==

'''Слот''' - это переменная, значение которой доступно во всех состояниях бота. Также значение слота сохраняется, если бота закрыли и продолжили
с ним работать через время.

Объявление слота происходит при первом присваивании в него значений. Например:

<syntaxhighlight lang="js">
a = 7
</syntaxhighlight>
объявляет слот с именем '''a''' и присваивает ему значение '''7'''



== Локальные переменные ==

В отличие от слотов локальные переменные сохраняются только внутри скрипта, где они объявлены. 
Объявление происходит путем добавления перед именем служебного слова '''local''':
<syntaxhighlight lang="js">
local b = 8 // локальная переменная
</syntaxhighlight>

Если локальная переменная объявлена внутри фигурных скобок '''{}''', то и ее значение доступно только там:

<syntaxhighlight lang="js">
local b = 8 // локальная переменная текущего скрипта

if (b == 8)
{
local c = 9 // локальная переменная блока оператора 'if'
print(c) // выведет 9
}

print(b) // выведет 8
print(c) // выдаст ошибку, т.к. тут уже переменная 'с' недоступна
</syntaxhighlight>



== Типы переменных ==

<syntaxhighlight lang="js">
sInt = 7 // целочисленный
sFloat = 7.3 // вещественный
sStr = "hello" // строковый
sArr = [7, 7.3, "hello", sStr] // массив
sDic = { n: 1, s: "Wine" } // словарь
sBool = true // бинарный
sRegExp = /[abc]/ // регулярное выражение
sNone = none // неопределенное значение
</syntaxhighlight>



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

* '''and''' - логическое ‘И’
* '''or''' - логическое ‘ИЛИ’
* '''not''' - отрицание ‘НЕТ’

Например:

<syntaxhighlight lang="vb">
a = true
b = false
c = true
res = not((a and b) or c)
</syntaxhighlight>



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

* '''+''' - сложение
* '''-''' - вычитание
* '''*''' - умножение
* '''/''' - деление

Например:

<syntaxhighlight lang="js">res = 2+3-4*5+(1.5-0.2/2)</syntaxhighlight>

== Комментарии ==

Комментарии используются для документирования фрагментов скрипта.
Могут быть многострочыми и однострочными:
<syntaxhighlight lang="js">
/*
Пример
многострочного
комментария
*/

a = 2253 // пример однострочного комментария

</syntaxhighlight>

Также разрешается и питоновский стиль комментария:
<syntaxhighlight lang="python">
a = 2253 # пример однострочного комментария
</syntaxhighlight>





== Работа со словарем (объектом) ==

Объявление словаря:

<syntaxhighlight lang="js">dic = { n: 1, s: "Wine" } </syntaxhighlight>

Доступ к значениям словаря:

<syntaxhighlight lang="js">a = dic.n // доступ к полю с именем "n" через точку
a = dic["n"] // доступ к полю с именем "n" через оператор доступа
dic["food"] = "milk" // добавление в словарь пары ключ-значение
</syntaxhighlight>

== Работа с массивами ==

Объявление массива:

<syntaxhighlight lang="js">
arr = [1,2,3] // создает массив с тремя элементами со значениями 1,2,3

</syntaxhighlight>

Доступ к элементам массива:

<syntaxhighlight lang="js">first = arr[0] // получить первый элемент массива
last = arr[-1] // получить последний элемент массива
last = arr[-2] // получить предпоследний элемент массива
arr[0] = 7 // изменить значение первого элемента</syntaxhighlight>
Функции работы с массивом:

'''''push(val1,val2...)''''' - добавить в конец массива элементы со значениями '''val1, val2...'''
<syntaxhighlight lang="js">
arr.push(4) // добавить значение '4' в конец массива
</syntaxhighlight>

'''''unshift(val1,val2...)''''' - добавить в начало массива элементы со значениями '''val1, val2...'''
<syntaxhighlight lang="js">
arr.unshift(0) // добавить значение '0' в начало
</syntaxhighlight>

'''''pop()''''' - удалить последний элемент массива и вернуть его значение

'''''shift()''''' - удалить первый элемент массива и вернуть его значение

'''''slice(start,end)''''' - возвращает часть массива начиная с позиции '''start''' и если указана переменная '''end''', то до нее не включая

'''''splice(start, deleteCount)''''' - удаляет '''deleteCount''' элементов начиная с позиции '''start'''

'''''clear()''''' - очистить массив

Функции работы с массивом словарей:

'''''find(EXPR)''''' - ищет элементы массива, удовлетворяющие условию '''EXPR'''. Найденные элементы возвращаются в виде массива 
Например:
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120},
{title: "Cheese", price: 100},
{title: "Cola", price: 40},
]

local res = arr.find(price > 80) // найти все объекты у которых поле 'price' больше 80 и вернуть их в массиве
print('найдено $res.length:') // выведет количество найденных объектов
print(res) // выведет объекты, удовлетворяющие условию
</syntaxhighlight>

'''''total(EXPR)''''' - применить выражение '''EXPR''' к каждому элементу массива и суммировать все значения 
Например посчитаем сумму товаров в корзине:
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
{title: "Cola", price: 40, amount: 3},
]

local res = arr.total(price * amount) // для каждого элемента массива умножаем цену на количество и складываем результат
print("К оплате: $res грн.") // выведет сумму товаров: "К оплате: 680 грн."
</syntaxhighlight>

'''''count(EXPR)''''' - найти количество элементов массива для которых истинно выражение '''EXPR'''
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
{title: "Cola", price: 40, amount: 3},
]

local res = arr.count(price < 100) // для каждого элемента массива умножаем цену на количество и складываем результат
print("Количество товаров, дешевле 100 грн: $res") // выведет количество товаров: "Количество товаров, дешевле 100 грн: 1"
</syntaxhighlight>

'''''sort(KEY)''''' - отсортировать массив

Поддерживаются только массивы, в которых все значения одного типа: число или строка для sort() и словарь для sort(key)

<syntaxhighlight lang="js">
list = [1, 3, 2] // массив чисел
str = ["a", "hi", "banana"] // массив строк
arr = [ // массив из словарей с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
]

list.sort() // отсортировать массив по возрастанию
str.sort() // отсортировать массив по возрастанию
arr.sort(price) // отсортировать массив объектов по ключу 'price'
// TODO
</syntaxhighlight>

'''''reverse()''''' - перевернуть массив
<syntaxhighlight lang="js">
list = [1, 3, 2] // массив

list.reverse() // [2, 3, 1]
</syntaxhighlight>



== Работа со строками ==

Объявление строковых слотов:

<syntaxhighlight lang="js">
str = "hello" // используя двойные кавычки
str = 'hello' // используя одинарные кавычки</syntaxhighlight>

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

<syntaxhighlight lang="js">
base = 'http://imgs/'
url = base + 'img1.png' // сложение строк
</syntaxhighlight>


Подстановка слотов в строки:
<syntaxhighlight lang="js">
a = 5
str = "a = $a" // вместо $a будет подставлено значение слота a
print(str) // выведет: "a = 5"
</syntaxhighlight>

Вставка выражений в строки:

Выражения можно вставлять в строки, обрамляя их фигурными скобками:
<syntaxhighlight lang="js">
str = "2 + 3 = {2+3}" // вычислит выражение и вставит результат в строку
print(str) // выведет: "2 + 3 = 5"
</syntaxhighlight>

Экранирование спецсимволов '$','{','}' происходит путем добавления наклонной черты '\'
<syntaxhighlight lang="js">
str = "price: 4.99\$ \{sale\}" // вычислит выражение и вставит результат в строку
print(str) // выведет: "price: 4.99$ {sale}"
</syntaxhighlight>

Функции работы со строками:

'''''length''''' - получить длинну строки
<syntaxhighlight lang="js">
str = "hello"
len = str.length // вернет 5 - число символов строки "hello"
</syntaxhighlight>

'''''substring(start,end)''''' - получить подстроку начиная с позиции '''start''' и до позиции '''end''' не включая
<syntaxhighlight lang="js">
str = "http://server/im.png"
substr = str.substring(7,13) // вернет строку "server"
</syntaxhighlight>

'''''search(pattern)''''' - найти позицию первого вхождения '''pattern''', иначе вернуть -1. Аргумент '''pattern''' может быть как строкой
так и регулярным выражением:

<syntaxhighlight lang="js">
str = "apple orange juice"
res = str.search('orange') // вернет позицию строки 'orange': 6
res = str.search(/(orange|juice)/) // вернет позицию строки 'orange' или 'juice'
res = str.search('pizza') // не найдет 'pizza' и вернет -1
</syntaxhighlight>



== Условный оператор ==
Оператор '''if''' используется, если необходимо ветвление логики в зависимости от условия

<syntaxhighlight lang="js">
a = 9
if (a > 7)
{
res = 'a more than 7'
}
else
{
res = 'a less or equal 7'
}</syntaxhighlight>
В данном примере проверяется условие <code>a > 7</code> и если оно истинно, то выполняется первый блок скрипта, окруженный фигурными скобками, иначе выполняется блок после служебного слова '''else'''



== Цикл '''while''' ==

Оператор цикла проверяет условие и пока оно истинно, выполняет код окруженный фигурными скобками

<syntaxhighlight lang="js">a = 7
while (a > 0)
{
a = a - 1
}</syntaxhighlight>
В данном примере скрипт <code>a = a - 1</code> будет выполнятся до тех пор пока значение слота <code>a</code> не станет равным нулю


== Итератор '''for''' ==

Итератор используется для перебора всех значений массива, либо ключей из словаря

<syntaxhighlight lang="js">
arr = [3,2,1]
for(val in arr)
{
print(val)
}
output:
3
2
1
</syntaxhighlight>
В данном примере цикл последовательно перебирает значения массива и заносит их во временную переменную '''val''' соответственно для каждого элемента массива выполняется окруженный фигурными скобками скрипт '''print(val)''' выводящий значение в отладочное окно

Иногда удобно в цикле иметь и индекс массива, для этого перед переменной значения добавляем имя переменной индекса:

<syntaxhighlight lang="js">
arr = [3,2,1]
for(i, val in arr)
{
print("$i: $val")
}
output:
0: 3
1: 2
2: 1
</syntaxhighlight>

Для перебора ключей и значений словаря используется аналогичная конструкция:
<syntaxhighlight lang="js">
arr = {pizza: 100, milk: 20, wine: 120}
for(key, val in arr)
{
print("$key: $val")
}
output:
pizza: 100
milk: 20
wine: 120
</syntaxhighlight>



== Оператор выбора '''switch''' ==

Конструкция '''switch''' заменяет собой сразу несколько '''if'''. Она представляет собой более наглядный способ сравнить выражение сразу с несколькими вариантами.
Имеет один или более блок '''case''' и необязательный блок '''default'''.

<syntaxhighlight lang="js">
a = 'one'
switch(a)
{
case 'one': print('one'); break;
case 'two': print('two'); break;
default: print('def')
}
</syntaxhighlight>

Переменная проверяется на строгое соответствие значению справа от '''case''' и если оно совпадает, то выполняется код до тех пор пока не встретится
оператор '''break'''

Если ни одно из '''case''' не подошло, выполняется код справа от '''default'''



== Оператор '''in''' ==

Оператор '''in''' проверяет есть ли значение в массиве либо является ключём в словаре.

<syntaxhighlight lang="js">
sArr = [7, 7.3, "hello"] // массив
print("hello" in sArr) // вернет true, т.к. значение "hello" присутствует в массиве sArr
sDic = { price: 100, food: "Wine"} // словарь
print("food" in sDic) // вернет true, т.к. ключ "food" присутствует в словаре sDic

</syntaxhighlight>

Переменная проверяется на строгое соответствие значению справа от '''case''' и если оно совпадает, то выполняется код до тех пор пока не встретится
оператор '''break'''

Если ни одно из '''case''' не подошло, выполняется код справа от '''default'''



== Оператор '''button''' ==

'''''button(caption){ SCRIPT }''''' 
Данный оператор добавляет в интерфейс кнопку с текстом '''caption''' в текущее сообщение. После нажатия на кнопку выполняется логика '''SCRIPT'''.
Если '''caption''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.

<syntaxhighlight lang="js">
button('click me') // текст в кнопке
{
// скрипт, который выполнится после нажатия
print('button was clicked!')
step('STATE_AFTER_CLICK')
}
</syntaxhighlight>

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



== Функции перехода ==

'''''run(state)''''' - выполнить логику шага '''state'''

'''''step(state)''''' - установка шага перехода по умолчанию в значение '''state'''

'''''goto(state)''''' - мгновенный переход в шаг '''state'''



== Функции работы с контентом ==

'''''text(obj)''''' - вывести в текущее сообщение текст. Если '''obj''' - это сторока, то она выводится не зависимо от текущего языка. Если '''obj''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.

<syntaxhighlight lang="js">
text("Hi world!")
text({ en: "Hi world!", ru: "Привет мир!", es: "¡Hola mundo!"})
</syntaxhighlight>

'''''images()''''' - создать новую строку картинок. Каждый последующий вызов image будет добавляться в эту строку, пока снова не будет вызван images().

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
images()
image(URL + "owl_a.png")
image(URL + "owl_b.png") </syntaxhighlight>

'''''image(url, width)''''' - вывести в текущее сообщение картинку. Если '''url''' - это строка, то он используется не зависимо от текущего языка. Если '''url''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.. Необязательный параметр '''width''' указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.png")
image({ en: URL + "en.png", ru: URL + "ru.png"})
</syntaxhighlight>

'''''buttons()''''' - создать новую строку кнопок. Каждый последующий вызов button будет добавляться в эту строку, пока снова не будет вызван buttons().

'''''get_check()''''' - получить массив значений кнопок типа check (1 - нажата, 0 - отжата)

'''''set_check(list)''''' - задать значения кнопок типа check из массива list.

<syntaxhighlight lang="js">
CHECK = [0,1,0]
set_check(CHECK)
</syntaxhighlight>

'''''get_radio()''''' - получить массив значений кнопок типа radio (1 - нажата, 0 - отжата). Единица будет одна.

'''''set_radio(list)''''' - задать значения кнопок типа radio из массива list.



== Отладчные функции ==

'''''print(args)''''' - вывод информации в окно отладки



== Округление ==

'''''floor(val)''''' - округление чисел в меньшую сторону:

<syntaxhighlight lang="js">floor(5.8) // 5
floor(-6.1) // -7</syntaxhighlight>
'''''trunc(val)''''' - отбрасывание дробной части:

<syntaxhighlight lang="js">trunc(5.51) // 5
trunc(-6.99) // -6</syntaxhighlight>
'''''ceil(val)''''' - округление чисел в большую сторону:

<syntaxhighlight lang="js">ceil(5.15) // 6</syntaxhighlight>
'''''round(val, num)''''' - округление '''val''' до '''num''' чисел после запятой:

<syntaxhighlight lang="js">round(3.14159265, 2) // 3.14</syntaxhighlight>


== Случайные числа ==

'''''randint(min,max)''''' - возвращает целое случайное число в диапазоне [min,max].

'''''random()''''' - возвращает случайное вещественное число в диапазоне [0,1].


== Дата и время ==

'''''date(format)''''' - возвращает текущую дату и время в указанном формате. По умолчанию аргумент '''format''' принимает значение: '''%d/%m/%Y %H:%M:%S'''

Поддерживаемые коды форматирования:

* '''%y''' - год без столетия ('22')
* '''%Y''' - год ('2022')
* '''%m''' - месяц
* '''%d''' - день
* '''%H''' - часы
* '''%M''' - минуты
* '''%S''' - секунды

Например:
<syntaxhighlight lang="js">
date() // 17/05/2022 18:16:31 т.е. сейчас
date('%Y.%m.%d %H:%M:%S') // 2022.05.17 18:16:31
</syntaxhighlight>

[[Category:Qubot]]

Qubot Script/ru

2022-05-26T08:35:02Z

Mkuznetsov:

{{TOCright}}
== Qubot Script ==

'''''Qubot Script''''' - это язык программирования, используемый для выполнения логических и математических операций при решении задач бота


== Слоты ==

'''Слот''' - это переменная, значение которой доступно во всех состояниях бота. Также значение слота сохраняется, если бота закрыли и продолжили
с ним работать через время.

Объявление слота происходит при первом присваивании в него значений. Например:

<syntaxhighlight lang="js">
a = 7
</syntaxhighlight>
объявляет слот с именем '''a''' и присваивает ему значение '''7'''



== Локальные переменные ==

В отличие от слотов локальные переменные сохраняются только внутри скрипта, где они объявлены. 
Объявление происходит путем добавления перед именем служебного слова '''local''':
<syntaxhighlight lang="js">
local b = 8 // локальная переменная
</syntaxhighlight>

Если локальная переменная объявлена внутри фигурных скобок '''{}''', то и ее значение доступно только там:

<syntaxhighlight lang="js">
local b = 8 // локальная переменная текущего скрипта

if (b == 8)
{
local c = 9 // локальная переменная блока оператора 'if'
print(c) // выведет 9
}

print(b) // выведет 8
print(c) // выдаст ошибку, т.к. тут уже переменная 'с' недоступна
</syntaxhighlight>



== Типы переменных ==

<syntaxhighlight lang="js">
sInt = 7 // целочисленный
sFloat = 7.3 // вещественный
sStr = "hello" // строковый
sArr = [7, 7.3, "hello", sStr] // массив
sDic = { n: 1, s: "Wine" } // словарь
sBool = true // бинарный
sRegExp = /[abc]/ // регулярное выражение
sNone = none // неопределенное значение
</syntaxhighlight>



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

* '''and''' - логическое ‘И’
* '''or''' - логическое ‘ИЛИ’
* '''not''' - отрицание ‘НЕТ’

Например:

<syntaxhighlight lang="vb">
a = true
b = false
c = true
res = not((a and b) or c)
</syntaxhighlight>



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

* '''+''' - сложение
* '''-''' - вычитание
* '''*''' - умножение
* '''/''' - деление

Например:

<syntaxhighlight lang="js">res = 2+3-4*5+(1.5-0.2/2)</syntaxhighlight>

== Комментарии ==

Комментарии используются для документирования фрагментов скрипта.
Могут быть многострочыми и однострочными:
<syntaxhighlight lang="js">
/*
Пример
многострочного
комментария
*/

a = 2253 // пример однострочного комментария

</syntaxhighlight>

Также разрешается и питоновский стиль комментария:
<syntaxhighlight lang="python">
a = 2253 # пример однострочного комментария
</syntaxhighlight>





== Работа со словарем (объектом) ==

Объявление словаря:

<syntaxhighlight lang="js">dic = { n: 1, s: "Wine" } </syntaxhighlight>

Доступ к значениям словаря:

<syntaxhighlight lang="js">a = dic.n // доступ к полю с именем "n" через точку
a = dic["n"] // доступ к полю с именем "n" через оператор доступа
dic["food"] = "milk" // добавление в словарь пары ключ-значение
</syntaxhighlight>

== Работа с массивами ==

Объявление массива:

<syntaxhighlight lang="js">
arr = [1,2,3] // создает массив с тремя элементами со значениями 1,2,3

</syntaxhighlight>

Доступ к элементам массива:

<syntaxhighlight lang="js">first = arr[0] // получить первый элемент массива
last = arr[-1] // получить последний элемент массива
last = arr[-2] // получить предпоследний элемент массива
arr[0] = 7 // изменить значение первого элемента</syntaxhighlight>
Функции работы с массивом:

'''''push(val1,val2...)''''' - добавить в конец массива элементы со значениями '''val1, val2...'''
<syntaxhighlight lang="js">
arr.push(4) // добавить значение '4' в конец массива
</syntaxhighlight>

'''''unshift(val1,val2...)''''' - добавить в начало массива элементы со значениями '''val1, val2...'''
<syntaxhighlight lang="js">
arr.unshift(0) // добавить значение '0' в начало
</syntaxhighlight>

'''''pop()''''' - удалить последний элемент массива и вернуть его значение

'''''shift()''''' - удалить первый элемент массива и вернуть его значение

'''''slice(start,end)''''' - возвращает часть массива начиная с позиции '''start''' и если указана переменная '''end''', то до нее не включая

'''''splice(start, deleteCount)''''' - удаляет '''deleteCount''' элементов начиная с позиции '''start'''

'''''clear()''''' - очистить массив

Функции работы с массивом словарей:

'''''find(EXPR)''''' - ищет элементы массива, удовлетворяющие условию '''EXPR'''. Найденные элементы возвращаются в виде массива 
Например:
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120},
{title: "Cheese", price: 100},
{title: "Cola", price: 40},
]

local res = arr.find(price > 80) // найти все объекты у которых поле 'price' больше 80 и вернуть их в массиве
print('найдено $res.length:') // выведет количество найденных объектов
print(res) // выведет объекты, удовлетворяющие условию
</syntaxhighlight>

'''''total(EXPR)''''' - применить выражение '''EXPR''' к каждому элементу массива и суммировать все значения 
Например посчитаем сумму товаров в корзине:
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
{title: "Cola", price: 40, amount: 3},
]

local res = arr.total(price * amount) // для каждого элемента массива умножаем цену на количество и складываем результат
print("К оплате: $res грн.") // выведет сумму товаров: "К оплате: 680 грн."
</syntaxhighlight>

'''''count(EXPR)''''' - найти количество элементов массива для которых истинно выражение '''EXPR'''
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
{title: "Cola", price: 40, amount: 3},
]

local res = arr.count(price < 100) // для каждого элемента массива умножаем цену на количество и складываем результат
print("Количество товаров, дешевле 100 грн: $res") // выведет количество товаров: "Количество товаров, дешевле 100 грн: 1"
</syntaxhighlight>

'''''sort(EXPR)''''' - отсортировать массив
<syntaxhighlight lang="js">
list = [1, 3, 2] // массив чисел
arr = [ // массив из объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
]

list.sort() // отсортировать массив по возрастанию
arr.sort(price) // отсортировать массив объектов по ключу 'price'
// TODO
</syntaxhighlight>

'''''reverse()''''' - перевернуть массив
<syntaxhighlight lang="js">
list = [1, 3, 2] // массив

list.reverse() // [2, 3, 1]
</syntaxhighlight>



== Работа со строками ==

Объявление строковых слотов:

<syntaxhighlight lang="js">
str = "hello" // используя двойные кавычки
str = 'hello' // используя одинарные кавычки</syntaxhighlight>

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

<syntaxhighlight lang="js">
base = 'http://imgs/'
url = base + 'img1.png' // сложение строк
</syntaxhighlight>


Подстановка слотов в строки:
<syntaxhighlight lang="js">
a = 5
str = "a = $a" // вместо $a будет подставлено значение слота a
print(str) // выведет: "a = 5"
</syntaxhighlight>

Вставка выражений в строки:

Выражения можно вставлять в строки, обрамляя их фигурными скобками:
<syntaxhighlight lang="js">
str = "2 + 3 = {2+3}" // вычислит выражение и вставит результат в строку
print(str) // выведет: "2 + 3 = 5"
</syntaxhighlight>

Экранирование спецсимволов '$','{','}' происходит путем добавления наклонной черты '\'
<syntaxhighlight lang="js">
str = "price: 4.99\$ \{sale\}" // вычислит выражение и вставит результат в строку
print(str) // выведет: "price: 4.99$ {sale}"
</syntaxhighlight>

Функции работы со строками:

'''''length''''' - получить длинну строки
<syntaxhighlight lang="js">
str = "hello"
len = str.length // вернет 5 - число символов строки "hello"
</syntaxhighlight>

'''''substring(start,end)''''' - получить подстроку начиная с позиции '''start''' и до позиции '''end''' не включая
<syntaxhighlight lang="js">
str = "http://server/im.png"
substr = str.substring(7,13) // вернет строку "server"
</syntaxhighlight>

'''''search(pattern)''''' - найти позицию первого вхождения '''pattern''', иначе вернуть -1. Аргумент '''pattern''' может быть как строкой
так и регулярным выражением:

<syntaxhighlight lang="js">
str = "apple orange juice"
res = str.search('orange') // вернет позицию строки 'orange': 6
res = str.search(/(orange|juice)/) // вернет позицию строки 'orange' или 'juice'
res = str.search('pizza') // не найдет 'pizza' и вернет -1
</syntaxhighlight>



== Условный оператор ==
Оператор '''if''' используется, если необходимо ветвление логики в зависимости от условия

<syntaxhighlight lang="js">
a = 9
if (a > 7)
{
res = 'a more than 7'
}
else
{
res = 'a less or equal 7'
}</syntaxhighlight>
В данном примере проверяется условие <code>a > 7</code> и если оно истинно, то выполняется первый блок скрипта, окруженный фигурными скобками, иначе выполняется блок после служебного слова '''else'''



== Цикл '''while''' ==

Оператор цикла проверяет условие и пока оно истинно, выполняет код окруженный фигурными скобками

<syntaxhighlight lang="js">a = 7
while (a > 0)
{
a = a - 1
}</syntaxhighlight>
В данном примере скрипт <code>a = a - 1</code> будет выполнятся до тех пор пока значение слота <code>a</code> не станет равным нулю


== Итератор '''for''' ==

Итератор используется для перебора всех значений массива, либо ключей из словаря

<syntaxhighlight lang="js">
arr = [3,2,1]
for(val in arr)
{
print(val)
}
output:
3
2
1
</syntaxhighlight>
В данном примере цикл последовательно перебирает значения массива и заносит их во временную переменную '''val''' соответственно для каждого элемента массива выполняется окруженный фигурными скобками скрипт '''print(val)''' выводящий значение в отладочное окно

Иногда удобно в цикле иметь и индекс массива, для этого перед переменной значения добавляем имя переменной индекса:

<syntaxhighlight lang="js">
arr = [3,2,1]
for(i, val in arr)
{
print("$i: $val")
}
output:
0: 3
1: 2
2: 1
</syntaxhighlight>

Для перебора ключей и значений словаря используется аналогичная конструкция:
<syntaxhighlight lang="js">
arr = {pizza: 100, milk: 20, wine: 120}
for(key, val in arr)
{
print("$key: $val")
}
output:
pizza: 100
milk: 20
wine: 120
</syntaxhighlight>



== Оператор выбора '''switch''' ==

Конструкция '''switch''' заменяет собой сразу несколько '''if'''. Она представляет собой более наглядный способ сравнить выражение сразу с несколькими вариантами.
Имеет один или более блок '''case''' и необязательный блок '''default'''.

<syntaxhighlight lang="js">
a = 'one'
switch(a)
{
case 'one': print('one'); break;
case 'two': print('two'); break;
default: print('def')
}
</syntaxhighlight>

Переменная проверяется на строгое соответствие значению справа от '''case''' и если оно совпадает, то выполняется код до тех пор пока не встретится
оператор '''break'''

Если ни одно из '''case''' не подошло, выполняется код справа от '''default'''



== Оператор '''in''' ==

Оператор '''in''' проверяет есть ли значение в массиве либо является ключём в словаре.

<syntaxhighlight lang="js">
sArr = [7, 7.3, "hello"] // массив
print("hello" in sArr) // вернет true, т.к. значение "hello" присутствует в массиве sArr
sDic = { price: 100, food: "Wine"} // словарь
print("food" in sDic) // вернет true, т.к. ключ "food" присутствует в словаре sDic

</syntaxhighlight>

Переменная проверяется на строгое соответствие значению справа от '''case''' и если оно совпадает, то выполняется код до тех пор пока не встретится
оператор '''break'''

Если ни одно из '''case''' не подошло, выполняется код справа от '''default'''



== Оператор '''button''' ==

'''''button(caption){ SCRIPT }''''' 
Данный оператор добавляет в интерфейс кнопку с текстом '''caption''' в текущее сообщение. После нажатия на кнопку выполняется логика '''SCRIPT'''.
Если '''caption''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.

<syntaxhighlight lang="js">
button('click me') // текст в кнопке
{
// скрипт, который выполнится после нажатия
print('button was clicked!')
step('STATE_AFTER_CLICK')
}
</syntaxhighlight>

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



== Функции перехода ==

'''''run(state)''''' - выполнить логику шага '''state'''

'''''step(state)''''' - установка шага перехода по умолчанию в значение '''state'''

'''''goto(state)''''' - мгновенный переход в шаг '''state'''



== Функции работы с контентом ==

'''''text(obj)''''' - вывести в текущее сообщение текст. Если '''obj''' - это сторока, то она выводится не зависимо от текущего языка. Если '''obj''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.

<syntaxhighlight lang="js">
text("Hi world!")
text({ en: "Hi world!", ru: "Привет мир!", es: "¡Hola mundo!"})
</syntaxhighlight>

'''''images()''''' - создать новую строку картинок. Каждый последующий вызов image будет добавляться в эту строку, пока снова не будет вызван images().

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
images()
image(URL + "owl_a.png")
image(URL + "owl_b.png") </syntaxhighlight>

'''''image(url, width)''''' - вывести в текущее сообщение картинку. Если '''url''' - это строка, то он используется не зависимо от текущего языка. Если '''url''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.. Необязательный параметр '''width''' указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.png")
image({ en: URL + "en.png", ru: URL + "ru.png"})
</syntaxhighlight>

'''''buttons()''''' - создать новую строку кнопок. Каждый последующий вызов button будет добавляться в эту строку, пока снова не будет вызван buttons().

'''''get_check()''''' - получить массив значений кнопок типа check (1 - нажата, 0 - отжата)

'''''set_check(list)''''' - задать значения кнопок типа check из массива list.

<syntaxhighlight lang="js">
CHECK = [0,1,0]
set_check(CHECK)
</syntaxhighlight>

'''''get_radio()''''' - получить массив значений кнопок типа radio (1 - нажата, 0 - отжата). Единица будет одна.

'''''set_radio(list)''''' - задать значения кнопок типа radio из массива list.



== Отладчные функции ==

'''''print(args)''''' - вывод информации в окно отладки



== Округление ==

'''''floor(val)''''' - округление чисел в меньшую сторону:

<syntaxhighlight lang="js">floor(5.8) // 5
floor(-6.1) // -7</syntaxhighlight>
'''''trunc(val)''''' - отбрасывание дробной части:

<syntaxhighlight lang="js">trunc(5.51) // 5
trunc(-6.99) // -6</syntaxhighlight>
'''''ceil(val)''''' - округление чисел в большую сторону:

<syntaxhighlight lang="js">ceil(5.15) // 6</syntaxhighlight>
'''''round(val, num)''''' - округление '''val''' до '''num''' чисел после запятой:

<syntaxhighlight lang="js">round(3.14159265, 2) // 3.14</syntaxhighlight>


== Случайные числа ==

'''''randint(min,max)''''' - возвращает целое случайное число в диапазоне [min,max].

'''''random()''''' - возвращает случайное вещественное число в диапазоне [0,1].


== Дата и время ==

'''''date(format)''''' - возвращает текущую дату и время в указанном формате. По умолчанию аргумент '''format''' принимает значение: '''%d/%m/%Y %H:%M:%S'''

Поддерживаемые коды форматирования:

* '''%y''' - год без столетия ('22')
* '''%Y''' - год ('2022')
* '''%m''' - месяц
* '''%d''' - день
* '''%H''' - часы
* '''%M''' - минуты
* '''%S''' - секунды

Например:
<syntaxhighlight lang="js">
date() // 17/05/2022 18:16:31 т.е. сейчас
date('%Y.%m.%d %H:%M:%S') // 2022.05.17 18:16:31
</syntaxhighlight>

[[Category:Qubot]]

Qubot Script/ru

2022-05-26T07:56:30Z

Mkuznetsov:

{{TOCright}}
== Qubot Script ==

'''''Qubot Script''''' - это язык программирования, используемый для выполнения логических и математических операций при решении задач бота


== Слоты ==

'''Слот''' - это переменная, значение которой доступно во всех состояниях бота. Также значение слота сохраняется, если бота закрыли и продолжили
с ним работать через время.

Объявление слота происходит при первом присваивании в него значений. Например:

<syntaxhighlight lang="js">
a = 7
</syntaxhighlight>
объявляет слот с именем '''a''' и присваивает ему значение '''7'''



== Локальные переменные ==

В отличие от слотов локальные переменные сохраняются только внутри скрипта, где они объявлены. 
Объявление происходит путем добавления перед именем служебного слова '''local''':
<syntaxhighlight lang="js">
local b = 8 // локальная переменная
</syntaxhighlight>

Если локальная переменная объявлена внутри фигурных скобок '''{}''', то и ее значение доступно только там:

<syntaxhighlight lang="js">
local b = 8 // локальная переменная текущего скрипта

if (b == 8)
{
local c = 9 // локальная переменная блока оператора 'if'
print(c) // выведет 9
}

print(b) // выведет 8
print(c) // выдаст ошибку, т.к. тут уже переменная 'с' недоступна
</syntaxhighlight>



== Типы переменных ==

<syntaxhighlight lang="js">
sInt = 7 // целочисленный
sFloat = 7.3 // вещественный
sStr = "hello" // строковый
sArr = [7, 7.3, "hello", sStr] // массив
sDic = { n: 1, s: "Wine" } // словарь
sBool = true // бинарный
sRegExp = /[abc]/ // регулярное выражение
sNone = none // неопределенное значение
</syntaxhighlight>



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

* '''and''' - логическое ‘И’
* '''or''' - логическое ‘ИЛИ’
* '''not''' - отрицание ‘НЕТ’

Например:

<syntaxhighlight lang="vb">
a = true
b = false
c = true
res = not((a and b) or c)
</syntaxhighlight>



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

* '''+''' - сложение
* '''-''' - вычитание
* '''*''' - умножение
* '''/''' - деление

Например:

<syntaxhighlight lang="js">res = 2+3-4*5+(1.5-0.2/2)</syntaxhighlight>

== Комментарии ==

Комментарии используются для документирования фрагментов скрипта.
Могут быть многострочыми и однострочными:
<syntaxhighlight lang="js">
/*
Пример
многострочного
комментария
*/

a = 2253 // пример однострочного комментария

</syntaxhighlight>

Также разрешается и питоновский стиль комментария:
<syntaxhighlight lang="python">
a = 2253 # пример однострочного комментария
</syntaxhighlight>





== Работа со словарем (объектом) ==

Объявление словаря:

<syntaxhighlight lang="js">dic = { n: 1, s: "Wine" } </syntaxhighlight>

Доступ к значениям словаря:

<syntaxhighlight lang="js">a = dic.n // доступ к полю с именем "n" через точку
a = dic["n"] // доступ к полю с именем "n" через оператор доступа
dic["food"] = "milk" // добавление в словарь пары ключ-значение
</syntaxhighlight>

== Работа с массивами ==

Объявление массива:

<syntaxhighlight lang="js">
arr = [1,2,3] // создает массив с тремя элементами со значениями 1,2,3

</syntaxhighlight>

Доступ к элементам массива:

<syntaxhighlight lang="js">first = arr[0] // получить первый элемент массива
last = arr[-1] // получить последний элемент массива
last = arr[-2] // получить предпоследний элемент массива
arr[0] = 7 // изменить значение первого элемента</syntaxhighlight>
Функции работы с массивом:

'''''push(val1,val2...)''''' - добавить в конец массива элементы со значениями '''val1, val2...'''
<syntaxhighlight lang="js">
arr.push(4) // добавить значение '4' в конец массива
</syntaxhighlight>

'''''unshift(val1,val2...)''''' - добавить в начало массива элементы со значениями '''val1, val2...'''
<syntaxhighlight lang="js">
arr.unshift(0) // добавить значение '0' в начало
</syntaxhighlight>

'''''pop()''''' - удалить последний элемент массива и вернуть его значение

'''''shift()''''' - удалить первый элемент массива и вернуть его значение

'''''slice(start,end)''''' - возвращает часть массива начиная с позиции '''start''' и если указана переменная '''end''', то до нее не включая

'''''splice(start, deleteCount)''''' - удаляет '''deleteCount''' элементов начиная с позиции '''start'''

'''''clear()''''' - очистить массив

Функции работы с массивом словарей:

'''''find(EXPR)''''' - ищет элементы массива, удовлетворяющие условию '''EXPR'''. Найденные элементы возвращаются в виде массива 
Например:
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120},
{title: "Cheese", price: 100},
{title: "Cola", price: 40},
]

local res = arr.find(price > 80) // найти все объекты у которых поле 'price' больше 80 и вернуть их в массиве
print('найдено $res.length:') // выведет количество найденных объектов
print(res) // выведет объекты, удовлетворяющие условию
</syntaxhighlight>

'''''total(EXPR)''''' - применить выражение '''EXPR''' к каждому элементу массива и суммировать все значения 
Например посчитаем сумму товаров в корзине:
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
{title: "Cola", price: 40, amount: 3},
]

local res = arr.total(price * amount) // для каждого элемента массива умножаем цену на количество и складываем результат
print("К оплате: $res грн.") // выведет сумму товаров: "К оплате: 680 грн."
</syntaxhighlight>

'''''count(EXPR)''''' - найти количество элементов массива для которых истинно выражение '''EXPR'''
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
{title: "Cola", price: 40, amount: 3},
]

local res = arr.count(price < 100) // для каждого элемента массива умножаем цену на количество и складываем результат
print("Количество товаров, дешевле 100 грн: $res") // выведет количество товаров: "Количество товаров, дешевле 100 грн: 1"
</syntaxhighlight>

'''''sort(REVERSE)''''' - отсортировать массив в '''REVERSE''' порядке, где '''REVERSE''' принимает значения true или false
<syntaxhighlight lang="js">
list = [1, 3, 2] // массив чисел

list.sort() // отсортировать массив по возрастанию
list.sort(true) // отсортировать массив по убыванию

</syntaxhighlight>

'''''sort(KEY, REVERSE)''''' - отсортировать массив объектов по ключу '''KEY''' в '''REVERSE''' порядке
<syntaxhighlight lang="js">
arr = [ // массив из объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
]

arr.sort('price') // отсортировать массив объектов по ключу 'price'
arr.sort('amount', true) // отсортировать массив объектов по убыванию по ключу 'amount'

</syntaxhighlight>



== Работа со строками ==

Объявление строковых слотов:

<syntaxhighlight lang="js">
str = "hello" // используя двойные кавычки
str = 'hello' // используя одинарные кавычки</syntaxhighlight>

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

<syntaxhighlight lang="js">
base = 'http://imgs/'
url = base + 'img1.png' // сложение строк
</syntaxhighlight>


Подстановка слотов в строки:
<syntaxhighlight lang="js">
a = 5
str = "a = $a" // вместо $a будет подставлено значение слота a
print(str) // выведет: "a = 5"
</syntaxhighlight>

Вставка выражений в строки:

Выражения можно вставлять в строки, обрамляя их фигурными скобками:
<syntaxhighlight lang="js">
str = "2 + 3 = {2+3}" // вычислит выражение и вставит результат в строку
print(str) // выведет: "2 + 3 = 5"
</syntaxhighlight>

Экранирование спецсимволов '$','{','}' происходит путем добавления наклонной черты '\'
<syntaxhighlight lang="js">
str = "price: 4.99\$ \{sale\}" // вычислит выражение и вставит результат в строку
print(str) // выведет: "price: 4.99$ {sale}"
</syntaxhighlight>

Функции работы со строками:

'''''length''''' - получить длинну строки
<syntaxhighlight lang="js">
str = "hello"
len = str.length // вернет 5 - число символов строки "hello"
</syntaxhighlight>

'''''substring(start,end)''''' - получить подстроку начиная с позиции '''start''' и до позиции '''end''' не включая
<syntaxhighlight lang="js">
str = "http://server/im.png"
substr = str.substring(7,13) // вернет строку "server"
</syntaxhighlight>

'''''search(pattern)''''' - найти позицию первого вхождения '''pattern''', иначе вернуть -1. Аргумент '''pattern''' может быть как строкой
так и регулярным выражением:

<syntaxhighlight lang="js">
str = "apple orange juice"
res = str.search('orange') // вернет позицию строки 'orange': 6
res = str.search(/(orange|juice)/) // вернет позицию строки 'orange' или 'juice'
res = str.search('pizza') // не найдет 'pizza' и вернет -1
</syntaxhighlight>



== Условный оператор ==
Оператор '''if''' используется, если необходимо ветвление логики в зависимости от условия

<syntaxhighlight lang="js">
a = 9
if (a > 7)
{
res = 'a more than 7'
}
else
{
res = 'a less or equal 7'
}</syntaxhighlight>
В данном примере проверяется условие <code>a > 7</code> и если оно истинно, то выполняется первый блок скрипта, окруженный фигурными скобками, иначе выполняется блок после служебного слова '''else'''



== Цикл '''while''' ==

Оператор цикла проверяет условие и пока оно истинно, выполняет код окруженный фигурными скобками

<syntaxhighlight lang="js">a = 7
while (a > 0)
{
a = a - 1
}</syntaxhighlight>
В данном примере скрипт <code>a = a - 1</code> будет выполнятся до тех пор пока значение слота <code>a</code> не станет равным нулю


== Итератор '''for''' ==

Итератор используется для перебора всех значений массива, либо ключей из словаря

<syntaxhighlight lang="js">
arr = [3,2,1]
for(val in arr)
{
print(val)
}
output:
3
2
1
</syntaxhighlight>
В данном примере цикл последовательно перебирает значения массива и заносит их во временную переменную '''val''' соответственно для каждого элемента массива выполняется окруженный фигурными скобками скрипт '''print(val)''' выводящий значение в отладочное окно

Иногда удобно в цикле иметь и индекс массива, для этого перед переменной значения добавляем имя переменной индекса:

<syntaxhighlight lang="js">
arr = [3,2,1]
for(i, val in arr)
{
print("$i: $val")
}
output:
0: 3
1: 2
2: 1
</syntaxhighlight>

Для перебора ключей и значений словаря используется аналогичная конструкция:
<syntaxhighlight lang="js">
arr = {pizza: 100, milk: 20, wine: 120}
for(key, val in arr)
{
print("$key: $val")
}
output:
pizza: 100
milk: 20
wine: 120
</syntaxhighlight>



== Оператор выбора '''switch''' ==

Конструкция '''switch''' заменяет собой сразу несколько '''if'''. Она представляет собой более наглядный способ сравнить выражение сразу с несколькими вариантами.
Имеет один или более блок '''case''' и необязательный блок '''default'''.

<syntaxhighlight lang="js">
a = 'one'
switch(a)
{
case 'one': print('one'); break;
case 'two': print('two'); break;
default: print('def')
}
</syntaxhighlight>

Переменная проверяется на строгое соответствие значению справа от '''case''' и если оно совпадает, то выполняется код до тех пор пока не встретится
оператор '''break'''

Если ни одно из '''case''' не подошло, выполняется код справа от '''default'''



== Оператор '''in''' ==

Оператор '''in''' проверяет есть ли значение в массиве либо является ключём в словаре.

<syntaxhighlight lang="js">
sArr = [7, 7.3, "hello"] // массив
print("hello" in sArr) // вернет true, т.к. значение "hello" присутствует в массиве sArr
sDic = { price: 100, food: "Wine"} // словарь
print("food" in sDic) // вернет true, т.к. ключ "food" присутствует в словаре sDic

</syntaxhighlight>

Переменная проверяется на строгое соответствие значению справа от '''case''' и если оно совпадает, то выполняется код до тех пор пока не встретится
оператор '''break'''

Если ни одно из '''case''' не подошло, выполняется код справа от '''default'''



== Оператор '''button''' ==

'''''button(caption){ SCRIPT }''''' 
Данный оператор добавляет в интерфейс кнопку с текстом '''caption''' в текущее сообщение. После нажатия на кнопку выполняется логика '''SCRIPT'''.
Если '''caption''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.

<syntaxhighlight lang="js">
button('click me') // текст в кнопке
{
// скрипт, который выполнится после нажатия
print('button was clicked!')
step('STATE_AFTER_CLICK')
}
</syntaxhighlight>

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



== Функции перехода ==

'''''run(state)''''' - выполнить логику шага '''state'''

'''''step(state)''''' - установка шага перехода по умолчанию в значение '''state'''

'''''goto(state)''''' - мгновенный переход в шаг '''state'''



== Функции работы с контентом ==

'''''text(obj)''''' - вывести в текущее сообщение текст. Если '''obj''' - это сторока, то она выводится не зависимо от текущего языка. Если '''obj''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.

<syntaxhighlight lang="js">
text("Hi world!")
text({ en: "Hi world!", ru: "Привет мир!", es: "¡Hola mundo!"})
</syntaxhighlight>

'''''images()''''' - создать новую строку картинок. Каждый последующий вызов image будет добавляться в эту строку, пока снова не будет вызван images().

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
images()
image(URL + "owl_a.png")
image(URL + "owl_b.png") </syntaxhighlight>

'''''image(url, width)''''' - вывести в текущее сообщение картинку. Если '''url''' - это строка, то он используется не зависимо от текущего языка. Если '''url''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.. Необязательный параметр '''width''' указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.png")
image({ en: URL + "en.png", ru: URL + "ru.png"})
</syntaxhighlight>

'''''buttons()''''' - создать новую строку кнопок. Каждый последующий вызов button будет добавляться в эту строку, пока снова не будет вызван buttons().

'''''get_check()''''' - получить массив значений кнопок типа check (1 - нажата, 0 - отжата)

'''''set_check(list)''''' - задать значения кнопок типа check из массива list.

<syntaxhighlight lang="js">
CHECK = [0,1,0]
set_check(CHECK)
</syntaxhighlight>

'''''get_radio()''''' - получить массив значений кнопок типа radio (1 - нажата, 0 - отжата). Единица будет одна.

'''''set_radio(list)''''' - задать значения кнопок типа radio из массива list.



== Отладчные функции ==

'''''print(args)''''' - вывод информации в окно отладки



== Округление ==

'''''floor(val)''''' - округление чисел в меньшую сторону:

<syntaxhighlight lang="js">floor(5.8) // 5
floor(-6.1) // -7</syntaxhighlight>
'''''trunc(val)''''' - отбрасывание дробной части:

<syntaxhighlight lang="js">trunc(5.51) // 5
trunc(-6.99) // -6</syntaxhighlight>
'''''ceil(val)''''' - округление чисел в большую сторону:

<syntaxhighlight lang="js">ceil(5.15) // 6</syntaxhighlight>
'''''round(val, num)''''' - округление '''val''' до '''num''' чисел после запятой:

<syntaxhighlight lang="js">round(3.14159265, 2) // 3.14</syntaxhighlight>


== Случайные числа ==

'''''randint(min,max)''''' - возвращает целое случайное число в диапазоне [min,max].

'''''random()''''' - возвращает случайное вещественное число в диапазоне [0,1].


== Дата и время ==

'''''date(format)''''' - возвращает текущую дату и время в указанном формате. По умолчанию аргумент '''format''' принимает значение: '''%d/%m/%Y %H:%M:%S'''

Поддерживаемые коды форматирования:

* '''%y''' - год без столетия ('22')
* '''%Y''' - год ('2022')
* '''%m''' - месяц
* '''%d''' - день
* '''%H''' - часы
* '''%M''' - минуты
* '''%S''' - секунды

Например:
<syntaxhighlight lang="js">
date() // 17/05/2022 18:16:31 т.е. сейчас
date('%Y.%m.%d %H:%M:%S') // 2022.05.17 18:16:31
</syntaxhighlight>

[[Category:Qubot]]

Qubot Script/ru

2022-05-17T15:19:23Z

Mkuznetsov:

{{TOCright}}
== Qubot Script ==

'''''Qubot Script''''' - это язык программирования, используемый для выполнения логических и математических операций при решении задач бота


== Слоты ==

'''Слот''' - это переменная, значение которой доступно во всех состояниях бота. Также значение слота сохраняется, если бота закрыли и продолжили
с ним работать через время.

Объявление слота происходит при первом присваивании в него значений. Например:

<syntaxhighlight lang="js">
a = 7
</syntaxhighlight>
объявляет слот с именем '''a''' и присваивает ему значение '''7'''



== Локальные переменные ==

В отличие от слотов локальные переменные сохраняются только внутри скрипта, где они объявлены. 
Объявление происходит путем добавления перед именем служебного слова '''local''':
<syntaxhighlight lang="js">
local b = 8 // локальная переменная
</syntaxhighlight>

Если локальная переменная объявлена внутри фигурных скобок '''{}''', то и ее значение доступно только там:

<syntaxhighlight lang="js">
local b = 8 // локальная переменная текущего скрипта

if (b == 8)
{
local c = 9 // локальная переменная блока оператора 'if'
print(c) // выведет 9
}

print(b) // выведет 8
print(c) // выдаст ошибку, т.к. тут уже переменная 'с' недоступна
</syntaxhighlight>



== Типы переменных ==

<syntaxhighlight lang="js">
sInt = 7 // целочисленный
sFloat = 7.3 // вещественный
sStr = "hello" // строковый
sArr = [7, 7.3, "hello", sStr] // массив
sDic = { n: 1, s: "Wine" } // словарь
sBool = true // бинарный
sRegExp = /[abc]/ // регулярное выражение
sNone = none // неопределенное значение
</syntaxhighlight>



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

* '''and''' - логическое ‘И’
* '''or''' - логическое ‘ИЛИ’
* '''not''' - отрицание ‘НЕТ’

Например:

<syntaxhighlight lang="vb">
a = true
b = false
c = true
res = not((a and b) or c)
</syntaxhighlight>



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

* '''+''' - сложение
* '''-''' - вычитание
* '''*''' - умножение
* '''/''' - деление

Например:

<syntaxhighlight lang="js">res = 2+3-4*5+(1.5-0.2/2)</syntaxhighlight>

== Комментарии ==

Комментарии используются для документирования фрагментов скрипта.
Могут быть многострочыми и однострочными:
<syntaxhighlight lang="js">
/*
Пример
многострочного
комментария
*/

a = 2253 // пример однострочного комментария

</syntaxhighlight>

Также разрешается и питоновский стиль комментария:
<syntaxhighlight lang="python">
a = 2253 # пример однострочного комментария
</syntaxhighlight>





== Работа со словарем (объектом) ==

Объявление словаря:

<syntaxhighlight lang="js">dic = { n: 1, s: "Wine" } </syntaxhighlight>

Доступ к значениям словаря:

<syntaxhighlight lang="js">a = dic.n // доступ к полю с именем "n" через точку
a = dic["n"] // доступ к полю с именем "n" через оператор доступа
dic["food"] = "milk" // добавление в словарь пары ключ-значение
</syntaxhighlight>

== Работа с массивами ==

Объявление массива:

<syntaxhighlight lang="js">
arr = [1,2,3] // создает массив с тремя элементами со значениями 1,2,3

</syntaxhighlight>

Доступ к элементам массива:

<syntaxhighlight lang="js">first = arr[0] // получить первый элемент массива
last = arr[-1] // получить последний элемент массива
last = arr[-2] // получить предпоследний элемент массива
arr[0] = 7 // изменить значение первого элемента</syntaxhighlight>
Функции работы с массивом:

'''''push(val1,val2...)''''' - добавить в конец массива элементы со значениями '''val1, val2...'''
<syntaxhighlight lang="js">
arr.push(4) // добавить значение '4' в конец массива
</syntaxhighlight>

'''''unshift(val1,val2...)''''' - добавить в начало массива элементы со значениями '''val1, val2...'''
<syntaxhighlight lang="js">
arr.unshift(0) // добавить значение '0' в начало
</syntaxhighlight>

'''''pop()''''' - удалить последний элемент массива и вернуть его значение

'''''shift()''''' - удалить первый элемент массива и вернуть его значение

'''''slice(start,end)''''' - возвращает часть массива начиная с позиции '''start''' и если указана переменная '''end''', то до нее не включая

'''''splice(start, deleteCount)''''' - удаляет '''deleteCount''' элементов начиная с позиции '''start'''

'''''clear()''''' - очистить массив

Функции работы с массивом словарей:

'''''find(EXPR)''''' - ищет элементы массива, удовлетворяющие условию '''EXPR'''. Найденные элементы возвращаются в виде массива 
Например:
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120},
{title: "Cheese", price: 100},
{title: "Cola", price: 40},
]

local res = arr.find(price > 80) // найти все объекты у которых поле 'price' больше 80 и вернуть их в массиве
print('найдено $res.length:') // выведет количество найденных объектов
print(res) // выведет объекты, удовлетворяющие условию
</syntaxhighlight>

'''''total(EXPR)''''' - применить выражение '''EXPR''' к каждому элементу массива и суммировать все значения 
Например посчитаем сумму товаров в корзине:
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
{title: "Cola", price: 40, amount: 3},
]

local res = arr.total(price * amount) // для каждого элемента массива умножаем цену на количество и складываем результат
print("К оплате: $res грн.") // выведет сумму товаров: "К оплате: 680 грн."
</syntaxhighlight>

'''''count(EXPR)''''' - найти количество элементов массива для которых истинно выражение '''EXPR'''
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
{title: "Cola", price: 40, amount: 3},
]

local res = arr.count(price < 100) // для каждого элемента массива умножаем цену на количество и складываем результат
print("Количество товаров, дешевле 100 грн: $res") // выведет количество товаров: "Количество товаров, дешевле 100 грн: 1"
</syntaxhighlight>



== Работа со строками ==

Объявление строковых слотов:

<syntaxhighlight lang="js">
str = "hello" // используя двойные кавычки
str = 'hello' // используя одинарные кавычки</syntaxhighlight>

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

<syntaxhighlight lang="js">
base = 'http://imgs/'
url = base + 'img1.png' // сложение строк
</syntaxhighlight>


Подстановка слотов в строки:
<syntaxhighlight lang="js">
a = 5
str = "a = $a" // вместо $a будет подставлено значение слота a
print(str) // выведет: "a = 5"
</syntaxhighlight>

Вставка выражений в строки:

Выражения можно вставлять в строки, обрамляя их фигурными скобками:
<syntaxhighlight lang="js">
str = "2 + 3 = {2+3}" // вычислит выражение и вставит результат в строку
print(str) // выведет: "2 + 3 = 5"
</syntaxhighlight>

Экранирование спецсимволов '$','{','}' происходит путем добавления наклонной черты '\'
<syntaxhighlight lang="js">
str = "price: 4.99\$ \{sale\}" // вычислит выражение и вставит результат в строку
print(str) // выведет: "price: 4.99$ {sale}"
</syntaxhighlight>

Функции работы со строками:

'''''length''''' - получить длинну строки
<syntaxhighlight lang="js">
str = "hello"
len = str.length // вернет 5 - число символов строки "hello"
</syntaxhighlight>

'''''substring(start,end)''''' - получить подстроку начиная с позиции '''start''' и до позиции '''end''' не включая
<syntaxhighlight lang="js">
str = "http://server/im.png"
substr = str.substring(7,13) // вернет строку "server"
</syntaxhighlight>

'''''search(pattern)''''' - найти позицию первого вхождения '''pattern''', иначе вернуть -1. Аргумент '''pattern''' может быть как строкой
так и регулярным выражением:

<syntaxhighlight lang="js">
str = "apple orange juice"
res = str.search('orange') // вернет позицию строки 'orange': 6
res = str.search(/(orange|juice)/) // вернет позицию строки 'orange' или 'juice'
res = str.search('pizza') // не найдет 'pizza' и вернет -1
</syntaxhighlight>



== Условный оператор ==
Оператор '''if''' используется, если необходимо ветвление логики в зависимости от условия

<syntaxhighlight lang="js">
a = 9
if (a > 7)
{
res = 'a more than 7'
}
else
{
res = 'a less or equal 7'
}</syntaxhighlight>
В данном примере проверяется условие <code>a > 7</code> и если оно истинно, то выполняется первый блок скрипта, окруженный фигурными скобками, иначе выполняется блок после служебного слова '''else'''



== Цикл '''while''' ==

Оператор цикла проверяет условие и пока оно истинно, выполняет код окруженный фигурными скобками

<syntaxhighlight lang="js">a = 7
while (a > 0)
{
a = a - 1
}</syntaxhighlight>
В данном примере скрипт <code>a = a - 1</code> будет выполнятся до тех пор пока значение слота <code>a</code> не станет равным нулю


== Итератор '''for''' ==

Итератор используется для перебора всех значений массива, либо ключей из словаря

<syntaxhighlight lang="js">
arr = [3,2,1]
for(val in arr)
{
print(val)
}
output:
3
2
1
</syntaxhighlight>
В данном примере цикл последовательно перебирает значения массива и заносит их во временную переменную '''val''' соответственно для каждого элемента массива выполняется окруженный фигурными скобками скрипт '''print(val)''' выводящий значение в отладочное окно

Иногда удобно в цикле иметь и индекс массива, для этого перед переменной значения добавляем имя переменной индекса:

<syntaxhighlight lang="js">
arr = [3,2,1]
for(i, val in arr)
{
print("$i: $val")
}
output:
0: 3
1: 2
2: 1
</syntaxhighlight>

Для перебора ключей и значений словаря используется аналогичная конструкция:
<syntaxhighlight lang="js">
arr = {pizza: 100, milk: 20, wine: 120}
for(key, val in arr)
{
print("$key: $val")
}
output:
pizza: 100
milk: 20
wine: 120
</syntaxhighlight>



== Оператор выбора '''switch''' ==

Конструкция '''switch''' заменяет собой сразу несколько '''if'''. Она представляет собой более наглядный способ сравнить выражение сразу с несколькими вариантами.
Имеет один или более блок '''case''' и необязательный блок '''default'''.

<syntaxhighlight lang="js">
a = 'one'
switch(a)
{
case 'one': print('one'); break;
case 'two': print('two'); break;
default: print('def')
}
</syntaxhighlight>

Переменная проверяется на строгое соответствие значению справа от '''case''' и если оно совпадает, то выполняется код до тех пор пока не встретится
оператор '''break'''

Если ни одно из '''case''' не подошло, выполняется код справа от '''default'''



== Оператор '''in''' ==

Оператор '''in''' проверяет есть ли значение в массиве либо является ключём в словаре.

<syntaxhighlight lang="js">
sArr = [7, 7.3, "hello"] // массив
print("hello" in sArr) // вернет true, т.к. значение "hello" присутствует в массиве sArr
sDic = { price: 100, food: "Wine"} // словарь
print("food" in sDic) // вернет true, т.к. ключ "food" присутствует в словаре sDic

</syntaxhighlight>

Переменная проверяется на строгое соответствие значению справа от '''case''' и если оно совпадает, то выполняется код до тех пор пока не встретится
оператор '''break'''

Если ни одно из '''case''' не подошло, выполняется код справа от '''default'''



== Оператор '''button''' ==

'''''button(caption){ SCRIPT }''''' 
Данный оператор добавляет в интерфейс кнопку с текстом '''caption''' в текущее сообщение. После нажатия на кнопку выполняется логика '''SCRIPT'''.
Если '''caption''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.

<syntaxhighlight lang="js">
button('click me') // текст в кнопке
{
// скрипт, который выполнится после нажатия
print('button was clicked!')
step('STATE_AFTER_CLICK')
}
</syntaxhighlight>

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



== Функции перехода ==

'''''run(state)''''' - выполнить логику шага '''state'''

'''''step(state)''''' - установка шага перехода по умолчанию в значение '''state'''

'''''goto(state)''''' - мгновенный переход в шаг '''state'''



== Функции работы с контентом ==

'''''text(obj)''''' - вывести в текущее сообщение текст. Если '''obj''' - это сторока, то она выводится не зависимо от текущего языка. Если '''obj''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.

<syntaxhighlight lang="js">
text("Hi world!")
text({ en: "Hi world!", ru: "Привет мир!", es: "¡Hola mundo!"})
</syntaxhighlight>

'''''images()''''' - создать новую строку картинок. Каждый последующий вызов image будет добавляться в эту строку, пока снова не будет вызван images().

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
images()
image(URL + "owl_a.png")
image(URL + "owl_b.png") </syntaxhighlight>

'''''image(url, width)''''' - вывести в текущее сообщение картинку. Если '''url''' - это строка, то он используется не зависимо от текущего языка. Если '''url''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.. Необязательный параметр '''width''' указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.png")
image({ en: URL + "en.png", ru: URL + "ru.png"})
</syntaxhighlight>

'''''buttons()''''' - создать новую строку кнопок. Каждый последующий вызов button будет добавляться в эту строку, пока снова не будет вызван buttons().

'''''get_check()''''' - получить массив значений кнопок типа check (1 - нажата, 0 - отжата)

'''''set_check(list)''''' - задать значения кнопок типа check из массива list.

<syntaxhighlight lang="js">
CHECK = [0,1,0]
set_check(CHECK)
</syntaxhighlight>

'''''get_radio()''''' - получить массив значений кнопок типа radio (1 - нажата, 0 - отжата). Единица будет одна.

'''''set_radio(list)''''' - задать значения кнопок типа radio из массива list.



== Отладчные функции ==

'''''print(args)''''' - вывод информации в окно отладки



== Округление ==

'''''floor(val)''''' - округление чисел в меньшую сторону:

<syntaxhighlight lang="js">floor(5.8) // 5
floor(-6.1) // -7</syntaxhighlight>
'''''trunc(val)''''' - отбрасывание дробной части:

<syntaxhighlight lang="js">trunc(5.51) // 5
trunc(-6.99) // -6</syntaxhighlight>
'''''ceil(val)''''' - округление чисел в большую сторону:

<syntaxhighlight lang="js">ceil(5.15) // 6</syntaxhighlight>
'''''round(val, num)''''' - округление '''val''' до '''num''' чисел после запятой:

<syntaxhighlight lang="js">round(3.14159265, 2) // 3.14</syntaxhighlight>


== Случайные числа ==

'''''randint(min,max)''''' - возвращает целое случайное число в диапазоне [min,max].

'''''random()''''' - возвращает случайное вещественное число в диапазоне [0,1].


== Дата и время ==

'''''date(format)''''' - возвращает текущую дату и время в указанном формате.

<syntaxhighlight lang="js">
date() // 17/05/2022 18:16:31 т.е. сейчас
date('YYYY:MM:DD HH:mm:SS') // 2022:05:17 18:16:31
</syntaxhighlight>

[[Category:Qubot]]

Qubot Script/ru

2022-05-09T06:54:55Z

Mkuznetsov: /* Отладочные функции */

{{TOCright}}
== Qubot Script ==

'''''Qubot Script''''' - это язык программирования, используемый для выполнения логических и математических операций при решении задач бота


== Слоты ==

'''Слот''' - это переменная, значение которой доступно во всех состояниях бота. Также значение слота сохраняется, если бота закрыли и продолжили
с ним работать через время.

Объявление слота происходит при первом присваивании в него значений. Например:

<syntaxhighlight lang="js">
a = 7
</syntaxhighlight>
объявляет слот с именем '''a''' и присваивает ему значение '''7'''



== Локальные переменные ==

В отличие от слотов локальные переменные сохраняются только внутри скрипта, где они объявлены. 
Объявление происходит путем добавления перед именем служебного слова '''local''':
<syntaxhighlight lang="js">
local b = 8 // локальная переменная
</syntaxhighlight>

Если локальная переменная объявлена внутри фигурных скобок '''{}''', то и ее значение доступно только там:

<syntaxhighlight lang="js">
local b = 8 // локальная переменная текущего скрипта

if (b == 8)
{
local c = 9 // локальная переменная блока оператора 'if'
print(c) // выведет 9
}

print(b) // выведет 8
print(c) // выдаст ошибку, т.к. тут уже переменная 'с' недоступна
</syntaxhighlight>



== Типы переменных ==

<syntaxhighlight lang="js">
sInt = 7 // целочисленный
sFloat = 7.3 // вещественный
sStr = "hello" // строковый
sArr = [7, 7.3, "hello", sStr] // массив
sDic = { n: 1, s: "Wine" } // словарь
sBool = true // бинарный
sRegExp = /[abc]/ // регулярное выражение
sNone = none // неопределенное значение
</syntaxhighlight>



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

* '''and''' - логическое ‘И’
* '''or''' - логическое ‘ИЛИ’
* '''not''' - отрицание ‘НЕТ’

Например:

<syntaxhighlight lang="vb">
a = true
b = false
c = true
res = not((a and b) or c)
</syntaxhighlight>



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

* '''+''' - сложение
* '''-''' - вычитание
* '''*''' - умножение
* '''/''' - деление

Например:

<syntaxhighlight lang="js">res = 2+3-4*5+(1.5-0.2/2)</syntaxhighlight>

== Комментарии ==

Комментарии используются для документирования фрагментов скрипта.
Могут быть многострочыми и однострочными:
<syntaxhighlight lang="js">
/*
Пример
многострочного
комментария
*/

a = 2253 // пример однострочного комментария

</syntaxhighlight>

Также разрешается и питоновский стиль комментария:
<syntaxhighlight lang="python">
a = 2253 # пример однострочного комментария
</syntaxhighlight>





== Работа со словарем (объектом) ==

Объявление словаря:

<syntaxhighlight lang="js">dic = { n: 1, s: "Wine" } </syntaxhighlight>

Доступ к значениям словаря:

<syntaxhighlight lang="js">a = dic.n // доступ к полю с именем "n" через точку
a = dic["n"] // доступ к полю с именем "n" через оператор доступа
dic["food"] = "milk" // добавление в словарь пары ключ-значение
</syntaxhighlight>

== Работа с массивами ==

Объявление массива:

<syntaxhighlight lang="js">
arr = [1,2,3] // создает массив с тремя элементами со значениями 1,2,3

</syntaxhighlight>

Доступ к элементам массива:

<syntaxhighlight lang="js">first = arr[0] // получить первый элемент массива
last = arr[-1] // получить последний элемент массива
last = arr[-2] // получить предпоследний элемент массива
arr[0] = 7 // изменить значение первого элемента</syntaxhighlight>
Функции работы с массивом:

'''''push(val1,val2...)''''' - добавить в конец массива элементы со значениями '''val1, val2...'''
<syntaxhighlight lang="js">
arr.push(4) // добавить значение '4' в конец массива
</syntaxhighlight>

'''''unshift(val1,val2...)''''' - добавить в начало массива элементы со значениями '''val1, val2...'''
<syntaxhighlight lang="js">
arr.unshift(0) // добавить значение '0' в начало
</syntaxhighlight>

'''''pop()''''' - удалить последний элемент массива и вернуть его значение

'''''shift()''''' - удалить первый элемент массива и вернуть его значение

'''''slice(start,end)''''' - возвращает часть массива начиная с позиции '''start''' и если указана переменная '''end''', то до нее не включая

'''''splice(start, deleteCount)''''' - удаляет '''deleteCount''' элементов начиная с позиции '''start'''

'''''clear()''''' - очистить массив

Функции работы с массивом словарей:

'''''find(EXPR)''''' - ищет элементы массива, удовлетворяющие условию '''EXPR'''. Найденные элементы возвращаются в виде массива 
Например:
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120},
{title: "Cheese", price: 100},
{title: "Cola", price: 40},
]

local res = arr.find(price > 80) // найти все объекты у которых поле 'price' больше 80 и вернуть их в массиве
print('найдено $res.length:') // выведет количество найденных объектов
print(res) // выведет объекты, удовлетворяющие условию
</syntaxhighlight>

'''''total(EXPR)''''' - применить выражение '''EXPR''' к каждому элементу массива и суммировать все значения 
Например посчитаем сумму товаров в корзине:
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
{title: "Cola", price: 40, amount: 3},
]

local res = arr.total(price * amount) // для каждого элемента массива умножаем цену на количество и складываем результат
print("К оплате: $res грн.") // выведет сумму товаров: "К оплате: 680 грн."
</syntaxhighlight>

'''''count(EXPR)''''' - найти количество элементов массива для которых истинно выражение '''EXPR'''
<syntaxhighlight lang="js">
arr = [ // массив из трех объектов с продуктами
{title: "Wine", price: 120, amount: 3},
{title: "Pizza", price: 100, amount: 2},
{title: "Cola", price: 40, amount: 3},
]

local res = arr.count(price < 100) // для каждого элемента массива умножаем цену на количество и складываем результат
print("Количество товаров, дешевле 100 грн: $res") // выведет количество товаров: "Количество товаров, дешевле 100 грн: 1"
</syntaxhighlight>



== Работа со строками ==

Объявление строковых слотов:

<syntaxhighlight lang="js">
str = "hello" // используя двойные кавычки
str = 'hello' // используя одинарные кавычки</syntaxhighlight>

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

<syntaxhighlight lang="js">
base = 'http://imgs/'
url = base + 'img1.png' // сложение строк
</syntaxhighlight>


Подстановка слотов в строки:
<syntaxhighlight lang="js">
a = 5
str = "a = $a" // вместо $a будет подставлено значение слота a
print(str) // выведет: "a = 5"
</syntaxhighlight>

Вставка выражений в строки:

Выражения можно вставлять в строки, обрамляя их фигурными скобками:
<syntaxhighlight lang="js">
str = "2 + 3 = {2+3}" // вычислит выражение и вставит результат в строку
print(str) // выведет: "2 + 3 = 5"
</syntaxhighlight>

Экранирование спецсимволов '$','{','}' происходит путем добавления наклонной черты '\'
<syntaxhighlight lang="js">
str = "price: 4.99\$ \{sale\}" // вычислит выражение и вставит результат в строку
print(str) // выведет: "price: 4.99$ {sale}"
</syntaxhighlight>

Функции работы со строками:

'''''length''''' - получить длинну строки
<syntaxhighlight lang="js">
str = "hello"
len = str.length // вернет 5 - число символов строки "hello"
</syntaxhighlight>

'''''substring(start,end)''''' - получить подстроку начиная с позиции '''start''' и до позиции '''end''' не включая
<syntaxhighlight lang="js">
str = "http://server/im.png"
substr = str.substring(7,13) // вернет строку "server"
</syntaxhighlight>

'''''search(pattern)''''' - найти позицию первого вхождения '''pattern''', иначе вернуть -1. Аргумент '''pattern''' может быть как строкой
так и регулярным выражением:

<syntaxhighlight lang="js">
str = "apple orange juice"
res = str.search('orange') // вернет позицию строки 'orange': 6
res = str.search(/(orange|juice)/) // вернет позицию строки 'orange' или 'juice'
res = str.search('pizza') // не найдет 'pizza' и вернет -1
</syntaxhighlight>



== Условный оператор ==
Оператор '''if''' используется, если необходимо ветвление логики в зависимости от условия

<syntaxhighlight lang="js">
a = 9
if (a > 7)
{
res = 'a more than 7'
}
else
{
res = 'a less or equal 7'
}</syntaxhighlight>
В данном примере проверяется условие <code>a > 7</code> и если оно истинно, то выполняется первый блок скрипта, окруженный фигурными скобками, иначе выполняется блок после служебного слова '''else'''



== Цикл '''while''' ==

Оператор цикла проверяет условие и пока оно истинно, выполняет код окруженный фигурными скобками

<syntaxhighlight lang="js">a = 7
while (a > 0)
{
a = a - 1
}</syntaxhighlight>
В данном примере скрипт <code>a = a - 1</code> будет выполнятся до тех пор пока значение слота <code>a</code> не станет равным нулю


== Итератор '''for''' ==

Итератор используется для перебора всех значений массива, либо ключей из словаря

<syntaxhighlight lang="js">
arr = [3,2,1]
for(val in arr)
{
print(val)
}
output:
3
2
1
</syntaxhighlight>
В данном примере цикл последовательно перебирает значения массива и заносит их во временную переменную '''val''' соответственно для каждого элемента массива выполняется окруженный фигурными скобками скрипт '''print(val)''' выводящий значение в отладочное окно

Иногда удобно в цикле иметь и индекс массива, для этого перед переменной значения добавляем имя переменной индекса:

<syntaxhighlight lang="js">
arr = [3,2,1]
for(i, val in arr)
{
print("$i: $val")
}
output:
0: 3
1: 2
2: 1
</syntaxhighlight>

Для перебора ключей и значений словаря используется аналогичная конструкция:
<syntaxhighlight lang="js">
arr = {pizza: 100, milk: 20, wine: 120}
for(key, val in arr)
{
print("$key: $val")
}
output:
pizza: 100
milk: 20
wine: 120
</syntaxhighlight>



== Оператор выбора '''switch''' ==

Конструкция '''switch''' заменяет собой сразу несколько '''if'''. Она представляет собой более наглядный способ сравнить выражение сразу с несколькими вариантами.
Имеет один или более блок '''case''' и необязательный блок '''default'''.

<syntaxhighlight lang="js">
a = 'one'
switch(a)
{
case 'one': print('one'); break;
case 'two': print('two'); break;
default: print('def')
}
</syntaxhighlight>

Переменная проверяется на строгое соответствие значению справа от '''case''' и если оно совпадает, то выполняется код до тех пор пока не встретится
оператор '''break'''

Если ни одно из '''case''' не подошло, выполняется код справа от '''default'''



== Оператор '''in''' ==

Оператор '''in''' проверяет есть ли значение в массиве либо является ключём в словаре.

<syntaxhighlight lang="js">
sArr = [7, 7.3, "hello"] // массив
print("hello" in sArr) // вернет true, т.к. значение "hello" присутствует в массиве sArr
sDic = { price: 100, food: "Wine"} // словарь
print("food" in sDic) // вернет true, т.к. ключ "food" присутствует в словаре sDic

</syntaxhighlight>

Переменная проверяется на строгое соответствие значению справа от '''case''' и если оно совпадает, то выполняется код до тех пор пока не встретится
оператор '''break'''

Если ни одно из '''case''' не подошло, выполняется код справа от '''default'''



== Оператор '''button''' ==

'''''button(caption){ SCRIPT }''''' 
Данный оператор добавляет в интерфейс кнопку с текстом '''caption''' в текущее сообщение. После нажатия на кнопку выполняется логика '''SCRIPT'''.
Если '''caption''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.

<syntaxhighlight lang="js">
button('click me') // текст в кнопке
{
// скрипт, который выполнится после нажатия
print('button was clicked!')
step('STATE_AFTER_CLICK')
}
</syntaxhighlight>

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



== Функции перехода ==

'''''run(state)''''' - выполнить логику шага '''state'''

'''''step(state)''''' - установка шага перехода по умолчанию в значение '''state'''

'''''goto(state)''''' - мгновенный переход в шаг '''state'''



== Функции работы с контентом ==

'''''text(obj)''''' - вывести в текущее сообщение текст. Если '''obj''' - это сторока, то она выводится не зависимо от текущего языка. Если '''obj''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.

<syntaxhighlight lang="js">
text("Hi world!")
text({ en: "Hi world!", ru: "Привет мир!", es: "¡Hola mundo!"})
</syntaxhighlight>

'''''images()''''' - создать новую строку картинок. Каждый последующий вызов image будет добавляться в эту строку, пока снова не будет вызван images().

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
images()
image(URL + "owl_a.png")
image(URL + "owl_b.png") </syntaxhighlight>

'''''image(url, width)''''' - вывести в текущее сообщение картинку. Если '''url''' - это строка, то он используется не зависимо от текущего языка. Если '''url''' - объект, то он должен состоять из двухбуквенных ключей (идентификаторов языка: en, ru,…) со строковыми значения на этих языках.. Необязательный параметр '''width''' указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.png")
image({ en: URL + "en.png", ru: URL + "ru.png"})
</syntaxhighlight>

'''''buttons()''''' - создать новую строку кнопок. Каждый последующий вызов button будет добавляться в эту строку, пока снова не будет вызван buttons().

'''''get_check()''''' - получить массив значений кнопок типа check (1 - нажата, 0 - отжата)

'''''set_check(list)''''' - задать значения кнопок типа check из массива list.

<syntaxhighlight lang="js">
CHECK = [0,1,0]
set_check(CHECK)
</syntaxhighlight>

'''''get_radio()''''' - получить массив значений кнопок типа radio (1 - нажата, 0 - отжата). Единица будет одна.

'''''set_radio(list)''''' - задать значения кнопок типа radio из массива list.



== Отладчные функции ==

'''''print(args)''''' - вывод информации в окно отладки



== Округление ==

'''''floor(val)''''' - округление чисел в меньшую сторону:

<syntaxhighlight lang="js">floor(5.8) // 5
floor(-6.1) // -7</syntaxhighlight>
'''''trunc(val)''''' - отбрасывание дробной части:

<syntaxhighlight lang="js">trunc(5.51) // 5
trunc(-6.99) // -6</syntaxhighlight>
'''''ceil(val)''''' - округление чисел в большую сторону:

<syntaxhighlight lang="js">ceil(5.15) // 6</syntaxhighlight>
'''''round(val, num)''''' - округление '''val''' до '''num''' чисел после запятой:

<syntaxhighlight lang="js">round(3.14159265, 2) // 3.14</syntaxhighlight>


== Случайные числа ==

'''''randint(min,max)''''' - возвращает целое случайное число в диапазоне [min,max].

'''''random()''''' - возвращает случайное вещественное число в диапазоне [0,1].

[[Category:Qubot]]