substring() | endswith() | startswith() | contains() | len() | concat() | splitter() | lower() | upper() | strip() | capitalize() | title() | normalizePhone() | replace() | base64() | base64decode() | urlencode() | urldecode() | hmac_hexdigest() | tg_escape() | select_random_from_list()
ОБОЗНАЧЕНИЯ:
! - Обязательные параметры
Примеры
Разберем функцию обрезки строки:
Определяем длину строки:
Очень часто при работе с таблицами нужна функция деления строки на части:
Обработка номера телефона:
Замена подстроки в строке
Использование
select_random_from_list(array) - возвращает случайный элемент из списка.
! array - список элементов. Обязательный параметр.
Примеры использования:
Пример1. Выбор случайного числа из списка чисел.
число_1 = 123
число_2 = 345
число_3 = 567
число_4 = 789
число_5 = 8764
my_array = [#{число_1}, #{число_2}, #{число_3}, #{число_4}, #{число_5}]
result = select_random_from_list(my_array)
Пример 2: Выбор случайной строки из списка.
приветствие_1 = "Добрый день!"
приветствие_2 = "Здравствуйте!"
приветствие_3 = "Привет!"
приветствие_4 = "Хай"
приветствие_5 = "Салют"
my_array = ["#{приветствие_1}", "#{приветствие_2}", "#{приветствие_3}", "#{приветствие_4}", "#{приветствие_5}"]
result = select_random_from_list(my_array)
Если работаем со строками - важно, чтобы передаваемые в список переменные были дополнительно обернуты в кавычки.
Пример кода для копирования
/*Разбираем substring()*/
text = 'тескт для обрезки'
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 = 'тескт для обрезки'
a=len(text)
b=len("как прекрасен этот мир!")
/*делим строку на части*/
elements = splitter('s, W, q', ',')
text='text1:text2:text3:text4:text5'
texts = splitter(text, ':',2)
/*title()*/
фио = петров аНАтолий ИваноВич
фио = title("#{фио}")
/*обработка номера телефона*/
phone=normalizePhone("+7978-999-99-99")
/*замена подстроки в строке*/
a=replace("wwww2222ww", "w", "e", 1)
Описание
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 к виду: первая буква заглавная, остальные - строчные.
Параметры:
! 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 - исходная строка
Например: Ivan Ivanovich станет Ivan%20Ivanovich, а Anna&Maria станет Anna%26Maria
urldecode(str) - для декодировки строки url.
Параметры:
! str - исходная строка
Например: Ivan%20Ivanovich будете переведено в Ivan Ivanovich
hmac_hexdigest(secret_key, msg, hash_type) - для шифрования строки 'sha256', 'md5', 'sha512' или 'sha1'
Параметры:
! secret_key - ключ
! msg - строка для шифрования
! hash_type - тип шифрования ( 'sha256', 'md5', 'sha512' или 'sha1')
select_random_from_list(array) - возвращает случайный элемент из списка.
! array - список элементов. Обязательный параметр.
tg_escape(str) - для экранирования переменной и вывода ее в сообщении Telegram с включенной разметкой. Функция ставит слеш перед перечисленными символами: '_', '*', '[', ']', '(', ')', '~', '`', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!'
Параметры:
! str - исходная строка