math

Макрос !{math} вычисляет математические выражения. Поддерживает арифметику, скобки, математические функции, константы, а также переменные и вложенные макросы.

Где используется:

• В любом тексте (сообщения, заголовки HTTP-запросов, тело запроса)
• В настройках переменных (значение для SetVarCloud / SetVarLocal)
• В условиях (для динамических диапазонов)

💡 Совет: Макрос удобен для подсчёта суммы, скидки, бонусов — любых вычислений внутри бота.

Синтаксис

!{math|выражение}

Именованных параметров у макроса нет: всё, что написано после |, целиком считается выражением.

Правила:

• Выражение может содержать числа, операторы, функции, константы, переменные ${...} и другие макросы !{...}
• Пробелы и переносы строк игнорируются
• Поддерживаются скобки для изменения приоритета
• Переменные и вложенные макросы подставляются в выражение до вычисления

Примеры вызова:

!{math|2 + 2}
!{math|10 * 5 - 3}
!{math|${var.person.score} + 10}
!{math|!{random.number|min:1; max:6} * 100}
!{math|(10 + 5) * 2}

Поддерживаемые операторы

⚠️ Важно: Других операторов нет. Возведения в степень (^, **) и остатка от деления (%) не существует — вместо них используйте функции pow(основание, степень) и mod(делимое, делитель). Выражение с ^ или % вернёт пустой результат.

Приоритет операций

Примеры расчёта:

Числа

⚠️ Важно: Разделитель дробной части — точка (.), а не запятая.

Правила записи чисел:

• Целая часть обязательна: 0.5 работает, .5 вызовет ошибку
• Экспоненциальная запись не поддерживается. Выражение 1.5e3 не выдаст ошибку, но всё после числа будет отброшено, и результат окажется 1.5. Большие и малые числа пишите полностью: 1500, 0.0000001
• Все вычисления идут с плавающей точкой, деление всегда дробное: 10 / 4 даст 2.5, а не 2. Для целого результата используйте floor, trunc или round
• Целые результаты выводятся без дробной части: 4, а не 4.0

Математические функции

Регистр названия не важен (pow, POW, Pow — одно и то же), аргументы разделяются запятой.

Часто используемые:

💡 Тригонометрические функции работают с радианами. Для градусов переводите вручную: sin(90 * pi / 180).

Константы

Регистр не важен.

Пример:

!{math|2 * pi * 5} => 31.41592653589793

Использование переменных

В выражении можно использовать переменные из контекста.

Примеры:

Прибавить 10 к переменной пользователя

!{math|${var.person.score} + 10}

Вычислить скидку 15% от суммы

!{math|${var.person.amount} * 0.85}

Ограничить значение диапазоном от 0 до 100

!{math|max(0, min(100, ${var.person.score}))}

💡 Совет: Переменные должны содержать числовые значения. Если переменная пуста или содержит текст, вычисление может дать ошибку или некорректный результат.

Использование макросов внутри !{math}

Макросы можно вкладывать друг в друга. Внутренний макрос выполняется первым, его результат подставляется в выражение.

Примеры:

Случайное число от 1 до 6, умноженное на 100

!{math|!{random.number|min:1; max:6} * 100}

Текущий Unix timestamp, делённый на 3600 (часы)

!{math|!{time|value:now; output_format:unix} / 3600}

Сколько полных лет аккаунту пользователя

!{math|floor((!{time|output_format:unix} - !{tgdate|output_format:unix}) / 31557600)}

Примеры

Базовые арифметические операции

• !{math|2 + 2} => 4
• !{math|10 - 3} => 7
• !{math|4 * 5} => 20
• !{math|15 / 3} => 5
• !{math|mod(10, 3)} => 1
• !{math|pow(2, 3)} => 8

Приоритет операций

• !{math|2 + 3 * 4} => 14 => Сначала умножение: 3*4=12, потом 2+12=14
• !{math|(2 + 3) * 4} => 20 => Сначала скобки: 2+3=5, потом 5*4=20
• !{math|pow(2, 3) * 2} => 16 => Сначала степень: 2 в степени 3 = 8, потом 8*2=16
• !{math|10 - 3 - 2} => 5 => Слева направо: 10-3=7, потом 7-2=5

С переменными

Предположим, у пользователя есть переменная score = 25

!{math|${var.person.score} + 5}

Результат: 30

!{math|${var.person.score} * 2 - 10}

Результат: 40

!{math|(${var.person.score} + 10) / 5}

Результат: 7

С макросами

Случайный бонус от 1 до 10% к текущему счёту

!{math|${var.person.score} * (1 + !{random.number|min:1; max:10} / 100)}

Округлённый до целого результат деления

!{math|round(!{time|value:now; output_format:unix} / 3600)}

Ошибки и их решение

⚠️ Параметры default и error в этом макросе не работают: они становятся частью выражения и ломают его. Запись !{math|2+2;default:0} всегда вернёт 0.

Быстрые ответы (шпаргалка)