Основы

Как устроен SQ

Когда, например, в тексте сообщения попадается выражение в двойных фигурных скобках {{ }}, бот вычисляет выражение внутри скобок и подставляет его значение в текст сообщения.

Например, значением выражения 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 == 0 and y > 0 or x != 0 and y < 0
False
​
>>> not (x == 0 and y > 0 or x != 0 and y < 0)
True
​
# допустим, что %пол% равен "женский"
>>> 'да' if %пол% == 'женский' else 'нет'
'да'
​
# допустим, что %сообщение% равно "привет мир"
>>> 'прив' in %сообщение%
True
​
>>> ' ' in %сообщение%
True
​
>>> 'пока' not in %сообщение%
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
12 345 678
​
# примечание: \ служит для экранирования кавычки в строке
>>> 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 и слова "кг".