Когда, например, в тексте сообщения попадается выражение в двойных фигурных скобках {{ }}, бот вычисляет выражение внутри скобок и подставляет его значение в текст сообщения.
Например, значением выражения 2 * 2 является число 4, а значением выражения "привет" — строка привет.
Примеры синтаксиса
Символом >>> в примерах ниже отмечен ввод пользователя, а на строку ниже указан результат вычисления этого выражения.
Символом # отмечены комментарии (пояснения) к коду.
Арифметика
>>>2*2
4
>>>2**(4+10/5)
64
Переменные
Переменные позволяют хранить данные пользователей.
Переменные делятся на типы: числа, строки, массивы и словари.
От типа переменной зависит набор действий, который можно с ней выполнить. Например, числа можно сравнивать (>, <, >=, <=, ==, !=), делить и умножать. Строки, можно только складывать.
Имена переменных в боте (специальные, локальные и глобальные) начинаются и заканчиваются со знака процента, например, %сообщение%. С точки зрения SQ эти проценты -- часть имени переменной, а создавать новые временные переменные в самом SQ можно без значков процента, например, x = 10.
Операции сравнения
>>> x =10
>>> x >0
True
>>> x <=0
False
>>> x ==10
True
>>> x +=2
>>> x
12
>>> x *=2
>>> x
24
>>> y =0
>>> x ==0and y >0or x !=0and y <0
False
>>>not(x ==0and y >0or x !=0and y <0)
True
# допустим, что %пол% равен "женский"
>>>'да'if%пол%=='женский'else'нет'
'да'
# допустим, что %сообщение% равно "привет мир"
>>>'прив'in%сообщение%
True
>>>' 'in%сообщение%
True
>>>'пока'notin%сообщение%
True
Вызов функций
Функции позволяют преобразовывать данные, например, получить длину строки, сгенерировать случайное число или добавить элемент в массив.
В SQ существует 3 варианта вызова функций: через точку, через пайп (|) и явно -- они взаимозаменяемые и равноценные.
>>>'привет'|len
6
>>>len('привет')
6
>>>'привет'.len()
6
Пара примеров:
# предположим, %сообщение% равно "привет мир"
>>>%сообщение%.startswith('привет')
True
>>>%сообщение%.endswith('привет')
False
>>>%сообщение%.endswith('мир')
True
>>>round(0.23)
0
>>>round(0.23,1)
0.2
>>>12345678| pretty
12345678
# примечание: \ служит для экранирования кавычки в строке
>>>12345678| pretty('\'')
12'345'678
>>> rand([1,2,3])
1
Работа с массивами
Массивы позволяют хранить несколько значений в одной переменной. Например, можно хранить список покупок клиента.
>>> корзина =[]
>>> корзина.push('хлеб')
>>> корзина.push('греча')
>>> корзина
['хлеб','греча']
>>>'хлеб'in корзина
True
>>>'сыр'in корзина
False
>>> корзина | pretty('\n')
хлеб
греча
Словари
Словарь похож на массив, но он позволяет запоминать сопоставление одного элемента — другому. Например, количество товара в корзине.
>>> корзина ={}
>>> корзина['хлеб']=3
>>> корзина['греча']=10
>>> корзина
{'хлеб':3,'греча':10}
>>>'хлеб'in корзина
True
>>>'сыр'in корзина
False
>>> корзина | pretty
хлеб:3
греча:10
Функциональное программирование
Это сложный для понимания раздел, если вы не были ранее знакомы с программированием. Вполне возможно, что вы можете пропустить этот раздел)
Лямбды (лямбда-выражения)
Лямбда (lambda) — анонимная функция.
В SQ нет возможности объявлять свои функции, но для некоторых задач, вроде преобразования массивов, фильтрации и сортировки можно использовать лямбда-выражения.
Синтаксис
Давайте для примера рассмотрим функцию, которая принимает 3 аргумента: a, b, c и возвращает их сумму:
a, b, c => a + b + c
Таким образом, лямбда-выражение состоит их 2 частей: списка аргументов (до стрелки) и выражения (после стрелки). Результат выражения вернётся при вызове этой функции.
Пример
>>> корзина ={}
>>> корзина['хлеб']=3
>>> корзина['греча']=10
# выведем словарь в нужном нам формате
>>> корзина |map((k, v)=> k +' - '+ v +' кг')| join
хлеб -3 кг
греча -10 кг
Тут мы использовали функцию map(), в которую передали в качестве аргумента нашу лямбду. Функция map() пройдёт по всем парам ключ-значение (k, v) в словаре корзина и вместо него вернёт строку — результат сложения k, дефиса, v и слова "кг".