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 ****- вихідний рядок
Розглянемо функцію обрізання рядка:


Визначення довжини рядка:


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


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


Заміна підрядка в рядку:




