substring() | endswith() | startswith() | contains() | len() | concat() | splitter() | lower() | upper() | strip() | capitalize() | title() | normalizePhone() | replace() | base64() | base64decode() | urlencode() | urldecode() | hmac_hexdigest() | select_random() | tg_escape()
ЛЕГЕНДА:
! ****- Обязательные параметры
Описание
substring(str, n1, n2) - для обрезки строки
Параметры:
! str ****- исходная строка
! n1 ****- количество символов для обрезки слева (> 0)
n2 - количество символов для обрезки справа (< 0)
endswith(str, substr) - для проверки, заканчивается ли строка заданной подстрокой
Параметры:
! str ****- исходная строка - "где искать"
! substr ****- строка поиска - "что искать"
startswith(str, substr) - для проверки, начинается ли строка с заданной подстроки
Параметры:
! str ****- исходная строка - "где искать"
! substr ****- строка поиска - "что искать"
contains(str, substr, registr) – для проверки, содержит ли первая строка вторую строку
Параметры:
! str ****- исходная строка - "где искать"
! substr ****- строка поиска - "что искать"
registr - флаг, указывающий, учитывать ли регистр (False означает, что регистр не учитывается)
len(str) – для подсчета количества символов в строке.
Параметры:
! str ****- исходная строка
concat(str1, str2) – для конкатенации (объединения) строк, переданных в качестве параметров
Параметры:
! str1 ****- строка 1
! str2 ****- строка 2
splitter(str, s, n) - для разделения строки на части. Функция возвращает массив элементов
Параметры:
! str ****- исходная строка
! s ****- разделитель строки
n - максимальное количество элементов
lower(str) – для преобразования строки в нижний регистр
Параметры:
! str ****- исходная строка
upper(str) - для преобразования строки в верхний регистр
Параметры:
! str ****- исходная строка
strip(str) - для удаления пробелов с обоих концов строки
Параметры:
! str ****- исходная строка
capitalize(str) - для замены первого символа строки его эквивалентом в верхнем регистре (делает первую букву слова заглавной).
Параметры:
! str ****- исходная строка
title(str) - для преобразования каждого слова в строке str так, чтобы первая буква была заглавной, а остальные - строчными
normalizePhone(str) - для форматирования номера телефона в стандартный вид: удаляет все нецифровые символы и заменяет начальную цифру 8 на 7, если она присутствует
Параметры:
! str ****- исходная строка с номером телефона
replace(str, s1, s2, n) - для замены подстроки в строке другой подстрокой
Параметры:
! str ****- исходная строка
! s1 ****- подстрока для замены
! s2 ****- подстрока для замены
n - количество замен
base64(str) – для кодирования строки в формат base64
Параметры:
! str ****- исходная строка
base64decode(str) - для декодирования base64 обратно в строку
Параметры:
! str ****- исходная строка
urlencode(str) - для кодирования строки, чтобы сделать ее безопасной для передачи по HTTP
Параметры:
! str ****- исходная строка
Например: John Smith становится John%20Smith, а Anna&Maria становится Anna%26Maria
urldecode(str) - для декодирования URL-закодированной строки
Параметры:
! str ****- исходная строка
Например: John%20Smith будет преобразовано в John Smith
hmac_hexdigest(secret_key, msg, hash_type) - для хеширования строки с использованием 'sha256', 'md5', 'sha512' или 'sha1'
Параметры:
! secret_key - ключ\ ! msg - строка для хеширования\ ! hash_type - тип хеша ('sha256', 'md5', 'sha512' или 'sha1')
select_random(str, s) - для выбора случайного элемента из строки с разделителями. Первый параметр - строка с элементами, второй - разделитель. Второй параметр по умолчанию равен '|'.
Параметры:
! str ****- исходная строка
! s ****- разделитель строки (по умолчанию '|')
Пример использования:
select_random('first element | second element | another element | and another one')
tg_escape(str) - для экранирования переменной и отображения ее в сообщении Telegram с включенной разметкой. Функция добавляет обратную косую черту перед следующими символами:
'_', '*', '[', ']', '(', ')', '~', '', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!'
Параметры:
! str ****- исходная строка
Примеры
Разберем функцию обрезки строки:


Определение длины строки:


Функция, разделяющая строку на части, часто требуется при работе с таблицами:


Обработка номера телефона:


Замена подстроки в строке:


Пример кода для копирования
/*Анализ substring()*/
text = 'text for trimming'
a=substring(text, 4)
a1=substring(text, -4)
b=substring(text, 4, 6)
b1=substring(text, 0, 6)
c=substring(text, 0, -4)
d=substring(text, 4, -4)
/*работа с len()*/
text = 'text to be trimmed'
a=len(text)
b=len("what a wonderful world!")
/*разделение строки на части*/
elements = splitter('s, W, q', ',')
text='text1:text2:text3:text4:text5'
texts = splitter(text, ':',2)
/*title()*/
full name = John Smith
full name = title("#{full name}")
/*обработка номера телефона*/
phone = normalizePhone("+971 50 123 4567")
/*замена подстроки в строке*/
a=replace("wwww2222ww", "w", "e", 1)