substring() | endswith() | startswith() | contains() | len() | concat() | splitter() | lower() | upper() | strip() | capitalize() | title() | normalizePhone() | replace() | base64() | base64decode() | urlencode() | urldecode() | hmac_hexdigest() | select_random() | tg_escape()
LEGENDA:
! ****- Parâmetros obrigatórios
substring(str, n1, n2) - para cortar uma string
Parâmetros:
! str ****- string original
! n1 ****- número de caracteres para cortar da esquerda (> 0)
n2 - número de caracteres para cortar da direita (< 0)
endswith(str, substr) - para verificar se a string termina com a substring fornecida
Parâmetros:
! str ****- string original - "onde pesquisar"
! substr ****- string de pesquisa - "o que pesquisar"
startswith(str, substr) - para verificar se a string começa com a substring fornecida
Parâmetros:
! str ****- string original - "onde pesquisar"
! substr ****- string de pesquisa - "o que pesquisar"
contains(str, substr, registr) – para verificar se a primeira string contém a segunda string
Parâmetros:
! str ****- string original - "onde pesquisar"
! substr ****- string de pesquisa - "o que pesquisar"
registr - um sinalizador que indica se deve considerar a sensibilidade a maiúsculas/minúsculas (False significa que maiúsculas/minúsculas não devem ser consideradas)
len(str) – para contar o número de caracteres em uma string.
Parâmetros:
! str ****- string original
concat(str1, str2) – para concatenar (unir) as strings passadas como parâmetros
Parâmetros:
! str1 ****- string 1
! str2 ****- string 2
splitter(str, s, n) - para dividir uma string em partes. A função retorna um array de elementos
Parâmetros:
! str ****- string original
! s ****- delimitador da string
n - número máximo de elementos
lower(str) – para converter uma string para minúsculas
Parâmetros:
! str ****- string original
upper(str) - para converter uma string para maiúsculas
Parâmetros:
! str ****- string original
strip(str) - para remover espaços em branco de ambas as extremidades de uma string
Parâmetros:
! str ****- string original
capitalize(str) - para substituir o primeiro caractere de uma string pelo seu equivalente em maiúscula (capitaliza a primeira letra da palavra).
Parâmetros:
! str ****- string original
title(str) - para converter cada palavra na string str de modo que a primeira letra seja maiúscula e as demais minúsculas
normalizePhone(str) - para formatar um número de telefone em um formato padrão: remove todos os caracteres não numéricos e substitui o dígito inicial 8 por 7, se presente
Parâmetros:
! str ****- string original com um número de telefone
replace(str, s1, s2, n) - para substituir uma substring em uma string por outra substring
Parâmetros:
! str ****- string original
! s1 ****- substring a ser substituída
! s2 ****- substring para substituir
n - número de substituições
base64(str) – para codificar uma string no formato base64
Parâmetros:
! str ****- string original
base64decode(str) - para decodificar base64 de volta para uma string
Parâmetros:
! str ****- string original
urlencode(str) - para codificar uma string para torná-la segura para transmissão HTTP
Parâmetros:
! str ****- string original
Por exemplo: John Smith torna-se John%20Smith, e Anna&Maria torna-se Anna%26Maria
urldecode(str) - para decodificar uma string codificada por URL
Parâmetros:
! str ****- string original
Por exemplo: John%20Smith será traduzido como John Smith
hmac_hexdigest(secret_key, msg, hash_type) - para fazer hash de uma string usando 'sha256', 'md5', 'sha512' ou 'sha1'
Parâmetros:
! secret_key - chave\ ! msg - string a ser hashada\ ! hash_type - tipo de hash ('sha256', 'md5', 'sha512' ou 'sha1')
select_random(str, s) - para selecionar um elemento aleatório de uma string delimitada. O primeiro parâmetro é a string com elementos, o segundo é o delimitador. O segundo parâmetro padrão é '|'.
Parâmetros:
! str ****- string original
! s ****- delimitador da string (padrão é '|')
Exemplo de uso:
select_random('first element | second element | another element | and another one')
tg_escape(str) - para escapar uma variável e exibi-la em uma mensagem do Telegram com marcação habilitada. A função adiciona uma barra invertida antes dos seguintes caracteres:
'_', '*', '[', ']', '(', ')', '~', '', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!'
Parâmetros:
! str ****- string original
Vamos analisar a função de corte de string:


Determinando o comprimento da string:


Uma função que divide uma string em partes é frequentemente necessária ao trabalhar com tabelas:


Processamento de número de telefone:


Substituindo uma substring em uma string:




