Функции этой группы работают с текстом: обрезают, делят, склеивают и меняют регистр.

Где пригодится:

  • обратиться к подписчику по имени с заглавной буквы;
  • разобрать ФИО или адрес на части;
  • собрать сообщение из нескольких полей;
  • проверить длину ответа.

Функции

ФункцияОписаниеПример
len(text)Возвращает количество символов в строке.len("Привет") → 6
upper(text)Преобразует текст в верхний регистр.upper("привет") → "ПРИВЕТ"
lower(text)Преобразует текст в нижний регистр.lower("HELLO") → "hello"
strip(text)Убирает пробелы в начале и в конце строки.strip(" привет ") → "привет"
capitalize(text)Делает первую букву строки заглавной, остальные — строчными.capitalize("иВАН") → "Иван"
title(text)Делает заглавной первую букву каждого слова, остальные — строчными.title("иван петров") → "Иван Петров"
substring(str, n1, n2)Обрезает строку: n1 — сколько символов пропустить слева, n2 — отрицательное число, сколько символов обрезать справа. n2 можно не указывать.substring("BotHelp", 3) → "Help"
substring("BotHelp", 3, -2) → "He"
split(text, separator, index)Делит строку по разделителю и возвращает часть с указанным номером (нумерация с 0). Если номер не указан, возвращается первая часть. Если такой части нет — пустая строка.split("Иван Петров", " ") → "Иван"
split("Иван Петров", " ", 1) → "Петров"
split_list(text, separator, max_parts)Делит строку по разделителю и возвращает все части списком. max_parts ограничивает количество частей (необязательно).split_list("курс, книга", ", ") → ["курс", "книга"]
replace(text, old, new, count)Заменяет часть строки на другую. По умолчанию заменяет все совпадения; count ограничивает количество замен (необязательно).replace("8-900-123", "-", "") → "8900123"
contains(text, pattern, ignore_case)Проверяет, есть ли в строке подстрока или шаблон. По умолчанию учитывает регистр; чтобы не учитывать, передайте третьим аргументом True.contains("хочу курс", "курс") → True
startswith(text, prefix)Проверяет, начинается ли строка с указанного текста.startswith("+79001234567", "+7") → True
endswith(text, suffix)Проверяет, заканчивается ли строка указанным текстом.endswith("mail@gmail.com", "gmail.com") → True

Даты в строковых функциях

Переменные типа «Дата» и «Дата и время» хранятся во внутреннем формате ГГГГ-ММ-ДД. Например, ввод 11.11.2011 хранится как "2011-11-11". Поэтому substring() обрезает дату именно по этому формату.

Чтобы получить ожидаемые значения:

Вариант 1: привести дату к привычному виду

date = format_date(client.birth_date, "%d.%m.%Y")

Вариант 2: обрезать дату с учётом формата ГГГГ-ММ-ДД

Используйте индексы строки "2011-11-11".

Пример: проверить длину ответа

Посчитаем количество символов в ответе через len. Переменные с нужными названиями необходимо создать заранее.

# Считаем количество символов
client.answer_count = len(client.answer)

# Проверяем, что символов 10 и больше: если да, в answer_valid запишется 1, если нет — 0
client.answer_valid = len(client.answer) >= 10

Пример: имя с заглавной буквы

Подписчик написал « иван петров». Возьмём первое слово и приведём его к нормальному виду.

client.first_name = title(split(strip(client.full_name), " "))

В first_name запишется Иван.

Пример: число судьбы

Посчитаем число судьбы — сумму всех цифр даты рождения. Дату подписчика передаём в переменной birth_date.

  • В 1 строке приводим дату к виду ДД.ММ.ГГГГ, потому что внутри BotHelp дата хранится как "2011-11-11".
  • Со 3 по 10 строку функцией substring выделяем каждую цифру и записываем в локальную переменную.
  • В 12 строке складываем цифры в переменную life_number для ответа подписчику.
date = format_date(client.birth_date, "%d.%m.%Y")

d1 = int(substring(date, 0, -9))
d2 = int(substring(date, 1, -8))
d3 = int(substring(date, 3, -6))
d4 = int(substring(date, 4, -5))
d5 = int(substring(date, 6, -3))
d6 = int(substring(date, 7, -2))
d7 = int(substring(date, 8, -1))
d8 = int(substring(date, 9, 0))

client.life_number = d1+d2+d3+d4+d5+d6+d7+d8

Перенос строки (\n)

Символ \n добавляет перенос строки внутри текста.

client.text = "Первая строка\nВторая строка"

Результат:

Первая строка
Вторая строка

Склеивание строк

1. Склеивание через оператор +

Объединяет несколько значений в одну строку и сохраняет результат в переменную. Пригодится, чтобы собрать итоговое сообщение, идентификатор или подпись.

  1. Склеивать через + можно только строки. Значения других типов сначала приведите к строке: str(client.A).
  2. Склеиваем значения через +.
  3. Результат присваиваем переменной.
client.result = "Заказ №" + client.order_id + " принят"

Что хранится в client.result: Заказ №12345 принят

Важно: оператор + создаёт новое значение. Если выполнить код ещё раз, предыдущее значение будет перезаписано.

2. Добавление текста через оператор +=

Постепенно дописывает текст в конец строки, не затирая предыдущее значение. Пригодится для логов, истории сообщений, накопления комментариев.

client.log = "Первое сообщение"
client.log += "\nВторое сообщение"
client.log += "\nТретье сообщение"

Что хранится в client.log:

Первое сообщение
Второе сообщение
Третье сообщение

Важно: оператор += не заменяет значение, а добавляет новое в конец строки. Для разделения строк используйте \n.

Например, будем копить в одной переменной историю вводов подписчика и добавлять к каждой записи время:

  1. Записываем текущее время в локальную переменную через get_current_time().
  2. Склеиваем номер заказа, перенос строки и время. Склеивать можно только строки — другие типы переведите через str().
  3. Добавляем запись в конец лога через +=, отделяя записи пустой строкой.

A = get_current_time()
client.проверка += ('\n' + '\n' + client.number_order + '\n' + ' ◷ ' + A)

Привести телефон к единому виду, принять ответ с опечаткой или найти фрагмент по шаблону — в статье Формула: проверка ответов подписчика.


Если вы не нашли ответ на свой вопрос, задайте его нам в чате внутри кабинета либо напишите в Telegram BotHelpSupportBot или на почту hello@bothelp.io

Получите 14 дней полного функционала платформы для создания рассылок, автоворонок и чат-ботов BotHelp.

Получить 14 дней бесплатно

Зарегистрируйтесь в BotHelp

14 дней полного доступа бесплатно. Хватит, чтобы собрать первого бота и проверить его на реальных подписчиках.

Создать аккаунт

Была ли статья полезна?

Наши каналыTelegramMAX
Спасибо за обратную связь!