QuData - User contributions [en]

Qubot Script/ru

2022-05-24T07:04:10Z

Abeyn: /* Дата и время */

{{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)''''' - возвращает текущую дату и время в указанном формате. По умолчанию аргумент '''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-24T07:03:08Z

Abeyn: /* Дата и время */

{{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)''''' - возвращает текущую дату и время в указанном формате. По умолчанию аргумент '''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-24T06:56:54Z

Abeyn: /* Дата и время */

{{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)''''' - возвращает текущую дату и время в указанном формате. По умолчанию аргумент format

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

<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-24T06:53:53Z

Abeyn: /* Дата и время */

{{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('%Y.%m.%d %H:%M:%S') // 2022.05.17 18:16:31
</syntaxhighlight>

[[Category:Qubot]]

Qubot Script/ru

2022-05-24T06:53:30Z

Abeyn: /* Дата и время */

{{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('%Y:%m:%d %H:%M:%S') // 2022:05:17 18:16:31
</syntaxhighlight>

[[Category:Qubot]]

Qubot Script/ru

2022-04-18T09:42:41Z

Abeyn: /* Работа с массивами */

{{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]]

Qubot Script/ru

2022-04-15T14:28:10Z

Abeyn: /* Работа с массивами */

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



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

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

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

Qubot Script/ru

2022-04-14T07:37:21Z

Abeyn: /* Типы переменных */

{{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,end)''''' - удаляет часть массива начиная с позиции '''start''' и если указана переменная '''end''', то до нее не включая

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



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

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

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

Qubot Script/ru

2022-04-14T05:50:23Z

Abeyn: /* Работа с массивами */

{{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]/ // регулярное выражение
sNull = null // неопределенное значение
</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,end)''''' - удаляет часть массива начиная с позиции '''start''' и если указана переменная '''end''', то до нее не включая

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



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

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

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

Qubot Script/ru

2022-04-13T09:28:32Z

Abeyn: /* Типы переменных */

{{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]/ // регулярное выражение
sNull = null // неопределенное значение
</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,end)''''' - удаляет часть массива начиная с позиции '''start''' и если указана переменная '''end''', то до нее не включая

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

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



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

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

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

Qubot Script/ru

2022-04-08T17:32:18Z

Abeyn: /* Работа с массивами */

{{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]/ // регулярное выражение
</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,end)''''' - удаляет часть массива начиная с позиции '''start''' и если указана переменная '''end''', то до нее не включая

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

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



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

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

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

Qubot Script/ru

2022-04-08T17:31:26Z

Abeyn: /* Работа с массивами */

{{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]/ // регулярное выражение
</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,end)''''' - удаляет часть массива начиная с позиции '''start''' и если указана переменная '''end''', то до нее не включая

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

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



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

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

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

Qubot Script/ru

2022-04-08T17:23:07Z

Abeyn: /* Работа со строками */

{{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]/ // регулярное выражение
</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''' и если указана переменная '''end''', то до нее не включая

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

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



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

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

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

Qubot Script/ru

2022-04-08T17:22:17Z

Abeyn: /* Работа со строками */

{{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]/ // регулярное выражение
</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''' и если указана переменная '''end''', то до нее не включая

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

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



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

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

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

Qubot Script/ru

2022-04-08T17:06:21Z

Abeyn: /* Работа с массивами */

{{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]/ // регулярное выражение
</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''' и если указана переменная '''end''', то до нее не включая

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

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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]]

Qubot Script/ru

2022-04-08T17:05:36Z

Abeyn: /* Работа с массивами */

{{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]/ // регулярное выражение
</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''' и если указана переменная '''end''', то до нее не включая

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

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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]]

Qubot Script/ru

2022-04-08T17:04:51Z

Abeyn: /* Работа с массивами */

{{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]/ // регулярное выражение
</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''' и если указана переменная '''end''', то до нее не включая

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

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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]]

Qubot Script/ru

2022-04-08T16:45:03Z

Abeyn: /* Работа с массивами */

{{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]/ // регулярное выражение
</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...)''''' - добавить в конец массива элемент со значением '''val'''
<syntaxhighlight lang="js">
arr.push(4) // добавить в конец массива элемент со значением '4'
</syntaxhighlight>

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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]]

Qubot Script/ru

2022-04-08T16:43:58Z

Abeyn:

{{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]/ // регулярное выражение
</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...)''''' - добавить в конец массива элемент со значением '''val'''
<syntaxhighlight lang="js">
arr.push(4)
</syntaxhighlight>

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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]]

Qubot Script/ru

2022-04-08T16:37:06Z

Abeyn: /* Комментарии */

{{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]/ // регулярное выражение
</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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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]]

Qubot Script/ru

2022-04-08T16:36:31Z

Abeyn: /* Комментарии */

{{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]/ // регулярное выражение
</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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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]]

Qubot Script/ru

2022-04-08T16:36:15Z

Abeyn: /* Комментарии */

{{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]/ // регулярное выражение
</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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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]]

Qubot Script/ru

2022-04-08T16:34:27Z

Abeyn: /* Комментарии */

{{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]/ // регулярное выражение
</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 // пример однострочного комментария в стиле JS
b = 21 # пример однострочного комментария в стиле PY

</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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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]]

Qubot Script/ru

2022-04-07T15:49:36Z

Abeyn: /* Итератор for */

{{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]/ // регулярное выражение
</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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]]

Qubot Script/ru

2022-04-07T15:46:11Z

Abeyn: /* Итератор for */

{{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]/ // регулярное выражение
</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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>



== Оператор выбора '''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]]

Qubot Script/ru

2022-04-07T14:38:02Z

Abeyn: /* Оператор button */

{{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]/ // регулярное выражение
</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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]]

Qubot Script/ru

2022-04-07T14:36:58Z

Abeyn: /* Оператор button */

{{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]/ // регулярное выражение
</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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'''.
<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]]

Qubot Script/ru

2022-04-07T14:13:21Z

Abeyn: /* Функции работы с контентом */

{{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]/ // регулярное выражение
</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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''' ==

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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]]

Qubot Script/ru

2022-04-07T14:12:48Z

Abeyn: /* Функции работы с контентом */

{{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]/ // регулярное выражение
</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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''' ==

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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")
text({ 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]]

Qubot Script/ru

2022-04-07T14:12:19Z

Abeyn: /* Функции работы с контентом */

{{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]/ // регулярное выражение
</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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''' ==

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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")
text({ 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]]

Qubot Script/ru

2022-04-07T14:10:16Z

Abeyn: /* Функции работы с контентом */

{{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]/ // регулярное выражение
</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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''' ==

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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") </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]]

Qubot Script/ru

2022-04-07T14:09:36Z

Abeyn: /* Функции работы с контентом */

{{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]/ // регулярное выражение
</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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''' ==

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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") </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]]

Qubot Script/ru

2022-04-07T10:02:45Z

Abeyn: /* Типы переменных */

{{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]/ // регулярное выражение
</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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''' ==

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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'''. Необязательный параметр '''width'''
указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.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]]

Qubot Script/ru

2022-04-07T10:02:08Z

Abeyn:

{{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 // бинарный</syntaxhighlight>
sRegExp = /[abc]/ // регулярное выражение


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

* '''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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -1
pos = str.search(/lo/) // получить позицию подстроки используя регулярное выражение, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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''' ==

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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'''. Необязательный параметр '''width'''
указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.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]]

Qubot Script/ru

2022-04-06T18:52:50Z

Abeyn: /* Оператор in */

{{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 // бинарный</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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''' ==

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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'''. Необязательный параметр '''width'''
указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.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]]

Qubot Script/ru

2022-04-06T18:51:41Z

Abeyn:

{{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 // бинарный</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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", sStr] // массив
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''' ==

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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'''. Необязательный параметр '''width'''
указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.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]]

Qubot Script/ru

2022-04-06T14:35:34Z

Abeyn: /* Работа со строками */

{{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 // бинарный</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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'''



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

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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'''. Необязательный параметр '''width'''
указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.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]]

Qubot Script/ru

2022-04-06T14:33:44Z

Abeyn: /* Работа со строками */

{{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 // бинарный</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

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

Функции работы со строками:
<syntaxhighlight lang="js">
str = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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'''



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

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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'''. Необязательный параметр '''width'''
указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.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]]

Qubot Script/ru

2022-03-31T05:49:46Z

Abeyn: /* Локальные переменные */

{{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 // бинарный</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

<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 = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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'''



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

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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'''. Необязательный параметр '''width'''
указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.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]]

Qubot Script/ru

2022-03-30T15:48:51Z

Abeyn: /* Оператор выбора switch */

{{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 // бинарный</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

<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 = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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'''



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

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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'''. Необязательный параметр '''width'''
указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.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]]

Qubot Script/ru

2022-03-30T15:48:20Z

Abeyn: /* Оператор выбора switch */

{{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 // бинарный</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

<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 = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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'''



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

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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'''. Необязательный параметр '''width'''
указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.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]]

Qubot Script/ru

2022-03-30T15:47:51Z

Abeyn:

{{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 // бинарный</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="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>
Функции работы с массивом:

<syntaxhighlight lang="js">len = arr.length // получить длинну массива
arr.push(4) // добавить в конец массива элемент со значением '4'
arr.unshift(0) // добавить в начало массива элемент со значением '0'
arr.pop() // удалить последний элемент массива
arr.shift() // удалить первый элемент массива
arr.slice(start,end) // возращает часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
arr.splice(start,end) // удаляет часть массива начиная с позиции 'start' и указана позиция 'end', то до нее (не включая)
</syntaxhighlight>

Поиск в массиве из словарей:

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



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

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

<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 = "hello"
len = str.length // получить длинну строки
sub = str.substring(3,5) // получить подстроку начиная с 3-й позиции и до 5-й не включая
pos = str.search('lo') // получить позицию подстроки, иначе -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)''' выводящий значение в отладочное окно



== Оператор выбора '''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'''



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

Данный оператор добавляет в интерфейс кнопку
с необходимым текстом и логику, которая должна быть
выполнена при нажатии
<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'''. Необязательный параметр '''width'''
указывает насколько в процентах нужно сжать изображение

<syntaxhighlight lang="js">
URL = "https://qudata.com/qubot/im/"
image(URL + "owl_a.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]]

Qubot Script/ru

2022-03-30T15:36:29Z

Abeyn:

Qubot Script/ru

2022-03-30T14:13:34Z

Abeyn: /* Работа с массивами */

Qubot Script/ru

2022-03-30T14:12:54Z

Abeyn: /* Работа с массивами */

Qubot Script/ru

2022-03-30T14:11:22Z

Abeyn:

Qubot Script/ru

2022-03-30T14:09:41Z

Abeyn: /* Работа с массивами */

Qubot Script/ru

2022-03-30T13:57:17Z

Abeyn: /* Работа с массивами */

Qubot Script/ru

2022-03-30T12:55:10Z

Abeyn: /* Работа со строками */

Qubot Script/ru

2022-03-30T12:46:57Z

Abeyn: /* Работа со строками */