----
== Deploying a chatbot on your website ==
First, you need to choose a chatbot.

To do this, go to the bot development console https://console.qudata.com/dashboard/bots and select the necessary chatbot by clicking directly on it.

[[File:1.png|700px]]

Now you can see the editing section of the chatbot.
Click '''Integrations''' on the left navigation panel and select the '''WebChat''' from available channels.

[[File:2.png|700px]]

In the settings for this channel enter a link to your website in the input field of Step 1.

[[File:3.png|700px]]

Then click the '''Copy''' button in Step 2.

[[File:4.png|700px]]

Open your webpage and access the HTML. Scroll down to the bottom and paste the copied text at the very end of the '''</body>''' tag.

[[File:5.png|700px]]

Return to the settings page and switch the slider to the active state.

[[File:6.png|700px]]

Reload your webpage. The bot will appear as a button in the bottom right.

[[File:7.png|700px]]

Congratulations, the bot has been successfully integrated into the WEB channel. Now the chatbot is available on your personal company website.

After that, you need to publish the chatbot on your website. To do this, click '''General settings''' on the left navigation panel.

[[File:Instruction 1.png|700px]]

In the '''Bot status''' section, select '''Published''' from the list and save the changes.

[[File:Instruction2.png|700px]]

Now, the chatbot is activated on your website and ready to respond to user inquiries.

[[File:Instruction3.png|700px]]

[[Category:Integrations]]

File:Instruction 1.png

2023-10-19T08:00:08Z

Tkachenko: Tkachenko uploaded a new version of File:Instruction 1.png

How to add a chatbot to your website

2023-10-18T14:31:46Z

Tkachenko:

----
== Deploying a chatbot on your website ==
First, you need to choose a chatbot.

To do this, go to the bot development console https://console.qudata.com/dashboard/bots and select the necessary chatbot by clicking directly on it.

[[File:1.png|700px]]

Now you can see the editing section of the chatbot.
Click '''Integrations''' on the left navigation panel and select the '''WebChat''' from available channels.

[[File:2.png|700px]]

In the settings for this channel enter a link to your website in the input field of Step 1.

[[File:3.png|700px]]

Then click the '''Copy''' button in Step 2.

[[File:4.png|700px]]

Open your webpage and access the HTML. Scroll down to the bottom and paste the copied text at the very end of the '''</body>''' tag.

[[File:5.png|700px]]

Return to the settings page and switch the slider to the active state.

[[File:6.png|700px]]

Reload your webpage. The bot will appear as a button in the bottom right.

[[File:7.png|700px]]

Congratulations, the bot has been successfully integrated into the WEB channel. Now the chatbot is available on your personal company website.

After that, you need to publish the chatbot on your website. To do this, choose '''General settings''' on the left navigation panel.

[[File:Instruction 1.png|700px]]

In the '''Bot status''' section, select '''Published''' from the list and save the changes.

[[File:Instruction2.png|700px]]

Now, the chatbot is activated on your website and ready to respond to user inquiries.

[[File:Instruction3.png|700px]]

[[Category:Integrations]]

How to add a chatbot to your website/ru

2023-10-18T13:05:49Z

Tkachenko:

[[Category:ru]]

{|style="float:right; margin-left:0.8em; clear:right;"
|+[[Main_Page/ru|В начало]]
|
'''Lang:'''
|
[[How to add a chatbot to your website|en]]
|}


----
== Установка чат-бота на собственный сайт ==
Для начала нам потребуется выбрать свой чат-бот.

Для этого перейдите в консоль разработки ботов https://console.qudata.com/dashboard/bots и выберите желаемый чат-бот, нажав прямо на него.

[[File:1.png|700px]]

Вы попадаете в раздел редактирования чат-бота.
Нажмите в боковой левой навигационной панели '''Integrations''' и выберите вид канала '''WebChat'''.

[[File:2.png|700px]]

В панели настройки данного канала, введите ссылку на ваш сайт в поле шага 1.

[[File:3.png|700px]]

Затем, в шаге 2, нажмите на кнопку '''Copy'''.

[[File:4.png|700px]]

Откройте свою веб-страницу и получите доступ к HTML. Прокрутите вниз и вставьте скопированный текст в самом конце тега '''</body>'''.

[[File:5.png|700px]]

Вернитесь на страницу настройки и переключите ползунок в активное состояние.

[[File:6.png|700px]]

Перезагрузите страницу вашего сайта. Бот появится в виде кнопки в правом нижнем углу.

[[File:7.png|700px]]

Поздравляем, бот успешно интегрирован в WEB канал. Теперь чат-бот доступен на вашем персональном сайте компании.

Далее чат-бот нужно опубликовать на сайте. Для этого перейдите в раздел консоли '''General settings'''.

[[File:Instruction 1.png|700px]]

В пункте '''Bot status''' выберите из перечня статус '''Published''' и сохраните изменения.

[[File:Instruction2.png|700px]]

Теперь чат-бот активирован на вашем сайте и готов отвечать на вопросы пользователей.

[[File:Instruction3.png|700px]]

[[Category:Integrations]]

How to add a chatbot to your website/ru

2023-10-18T13:01:09Z

File:Instruction2.png

2023-10-18T12:12:21Z

Tkachenko:

File:Instruction 1.png

2023-10-18T12:07:29Z

Tkachenko: Tkachenko uploaded a new version of File:Instruction 1.png

How to add a chatbot to your website/ru

2023-10-18T12:05:01Z

Tkachenko:

[[Category:ru]]

{|style="float:right; margin-left:0.8em; clear:right;"
|+[[Main_Page/ru|В начало]]
|
'''Lang:'''
|
[[How to add a chatbot to your website|en]]
|}


----
== Установка чат-бота на собственный сайт ==
Для начала нам потребуется выбрать свой чат-бот.

Для этого перейдите в консоль разработки ботов https://console.qudata.com/dashboard/bots и выберите желаемый чат-бот, нажав прямо на него.

[[File:1.png|700px]]

Вы попадаете в раздел редактирования чат-бота.
Нажмите в боковой левой навигационной панели '''Integrations''' и выберите вид канала '''WebChat'''.

[[File:2.png|700px]]

В панели настройки данного канала, введите ссылку на ваш сайт в поле шага 1.

[[File:3.png|700px]]

Затем, в шаге 2, нажмите на кнопку '''Copy'''.

[[File:4.png|700px]]

Откройте свою веб-страницу и получите доступ к HTML. Прокрутите вниз и вставьте скопированный текст в самом конце тега '''</body>'''.

[[File:5.png|700px]]

Вернитесь на страницу настройки и переключите ползунок в активное состояние.

[[File:6.png|700px]]

Перезагрузите страницу вашего сайта. Бот появится в виде кнопки в правом нижнем углу.

[[File:7.png|700px]]

Поздравляем, бот успешно интегрирован в WEB канал. Теперь чат-бот доступен на вашем персональном сайте компании.

Далее чат-бот нужно опубликовать на сайте. Для этого перейдите в раздел консоли '''General settings'''.

[[File:Instruction 1.png|700px]]

[[Category:Integrations]]

2022-06-30T08:00:29Z

Tkachenko:

{{TOCright}}
== Qubot Script ==

'''''Qubot Script''''' - is a programming language used to perform logical and mathematical operations while solving bot tasks


== Slots ==

'''Slot''' - is a variable whose value is available in all states of the bot. Also, the value of the slot is saved if the bot is closed and then the work is continued after a while.

A slot is declared for the first time when values are assigned to it. For example:

<syntaxhighlight lang="js">
a = 7
</syntaxhighlight>
A slot named '''a''' is declared and the value '''7''' is assigned to it



== Local variables ==

Unlike slots, local variables are stored only within the script where they are declared. 
The declaration is made by adding the keyword '''local''' before the name:
<syntaxhighlight lang="js">
local b = 8 // local variable
</syntaxhighlight>

If a local variable is declared inside curly braces '''{}''', then its value is only available there:

<syntaxhighlight lang="js">
local b = 8 // local variable of the current script

if (b == 8)
{
local c = 9 // local variable of 'if' statement block
print(c) // will output 9
}

print(b) // will output 8
print(c) // will give an error, because the variable 'с' is unavailable here
</syntaxhighlight>



== Variable types ==

<syntaxhighlight lang="js">
sInt = 7 // Integer
sFloat = 7.3 // Float
sStr = "hello" // String
sArr = [7, 7.3, "hello", sStr] // Array
sDic = { n: 1, s: "Wine" } // Dictionary
sBool = true // Boolean
sRegExp = /[abc]/ // Regular expression
sNone = none // Undefined value
</syntaxhighlight>



== Boolean operations ==

* '''and''' - logical ‘AND’
* '''or''' - logical ‘OR’
* '''not''' - negation ‘NO’

For example:

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



== Arithmetic operations ==

* '''+''' - addition
* '''-''' - subtraction
* '''*''' - multiplication
* '''/''' - division

For example:

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

== Comments ==

Comments are used to document script fragments.
They can be multi-line and single-line:
<syntaxhighlight lang="js">
/*
Example of
multi-line
comment
*/

a = 2253 // example of single-line comment

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

2022-06-30T07:34:04Z

Tkachenko:

{{TOCright}}
== Qubot Script ==

'''''Qubot Script''''' - is a programming language used to perform logical and mathematical operations while solving bot tasks


== Slots ==

'''Slot''' - is a variable whose value is available in all states of the bot. Also, the value of the slot is saved if the bot is closed and then the work is continued after a while.

A slot is declared for the first time when values are assigned to it. For example:

<syntaxhighlight lang="js">
a = 7
</syntaxhighlight>
A slot named '''a''' is declared and the value '''7''' is assigned to it



== Local variables ==

Unlike slots, local variables are stored only within the script where they are declared. 
The declaration is made by adding the keyword '''local''' before the name:
<syntaxhighlight lang="js">
local b = 8 // local variable
</syntaxhighlight>

If a local variable is declared inside curly braces '''{}''', then its value is only available there:

<syntaxhighlight lang="js">
local b = 8 // local variable of the current script

if (b == 8)
{
local c = 9 // local variable of 'if' statement block
print(c) // will output 9
}

print(b) // will output 8
print(c) // will give an error, because the variable 'с' is unavailable here
</syntaxhighlight>



== Variable types ==

<syntaxhighlight lang="js">
sInt = 7 // Integer
sFloat = 7.3 // Float
sStr = "hello" // String
sArr = [7, 7.3, "hello", sStr] // Array
sDic = { n: 1, s: "Wine" } // Dictionary
sBool = true // Boolean
sRegExp = /[abc]/ // Regular expression
sNone = none // Undefined value
</syntaxhighlight>



== Boolean operations ==

* '''and''' - logical ‘AND’
* '''or''' - logical ‘OR’
* '''not''' - negation ‘NO’

Например:

<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

2022-06-30T07:13:06Z

Tkachenko: Removed redirect to Qubot Script/ru

{{TOCright}}
== Qubot Script ==

'''''Qubot Script''''' - is a programming language used to perform logical and mathematical operations while solving bot tasks


== Slots ==

'''Slot''' - is a variable whose value is available in all states of the bot. Also, the value of the slot is saved if the bot is closed and then the work is continued after a while.

A slot is declared for the first time when values are assigned to it. For example:

<syntaxhighlight lang="js">
a = 7
</syntaxhighlight>
A slot named '''a''' is declared and the value '''7''' is assigned to it



== Local variables ==

В отличие от слотов локальные переменные сохраняются только внутри скрипта, где они объявлены. 
Объявление происходит путем добавления перед именем служебного слова '''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]]