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 ****- исходная строка

Разберем функцию обрезки строки:

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

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

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

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