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)