Trabajando con cadenas

LEYENDA:

! ****- Parámetros obligatorios

substring(str, n1, n2) - para recortar una cadena

Parámetros:

! str ****- cadena original

! n1 ****- número de caracteres a recortar desde la izquierda (> 0)

n2 - número de caracteres a recortar desde la derecha (< 0)

endswith(str, substr) - para verificar si la cadena termina con la subcadena dada

Parámetros:

! str ****- cadena original - "dónde buscar"

! substr ****- subcadena de búsqueda - "qué buscar"

startswith(str, substr) - para verificar si la cadena comienza con la subcadena dada

Parámetros:

! str ****- cadena original - "dónde buscar"

! substr ****- subcadena de búsqueda - "qué buscar"

contains(str, substr, registr) – para verificar si la primera cadena contiene la segunda cadena

Parámetros:

! str ****- cadena original - "dónde buscar"

! substr ****- subcadena de búsqueda - "qué buscar"

registr - un indicador que determina si se debe considerar la sensibilidad a mayúsculas/minúsculas (False significa que no se debe considerar)

len(str) – para contar el número de caracteres en una cadena.

Parámetros:

! str ****- cadena original

concat(str1, str2) – para concatenar (unir) las cadenas pasadas como parámetros

Parámetros:

! str1 ****- cadena 1

! str2 ****- cadena 2

splitter(str, s, n) - para dividir una cadena en partes. La función devuelve un arreglo de elementos

Parámetros:

! str ****- cadena original

! s ****- delimitador de cadena

n - número máximo de elementos

lower(str) – para convertir una cadena a minúsculas

Parámetros:

! str ****- cadena original

upper(str) - para convertir una cadena a mayúsculas

Parámetros:

! str ****- cadena original

strip(str) - para eliminar espacios en blanco de ambos extremos de una cadena

Parámetros:

! str ****- cadena original

capitalize(str) - para reemplazar el primer carácter de una cadena con su equivalente en mayúscula (pone en mayúscula la primera letra de la palabra).

Parámetros:

! str ****- cadena original

title(str) - para convertir cada palabra en la cadena str de modo que la primera letra esté en mayúscula y las demás en minúscula

normalizePhone(str) - para formatear un número de teléfono a una forma estándar: elimina todos los caracteres no numéricos y reemplaza el dígito inicial 8 por 7 si está presente

Parámetros:

! str ****- cadena original con un número de teléfono

replace(str, s1, s2, n) - para reemplazar una subcadena en una cadena con otra subcadena

Parámetros:

! str ****- cadena original

! s1 ****- subcadena a reemplazar

! s2 ****- subcadena de reemplazo

n - número de reemplazos

base64(str) – para codificar una cadena en formato base64

Parámetros:

! str ****- cadena original

base64decode(str) - para decodificar base64 de vuelta a una cadena

Parámetros:

! str ****- cadena original

urlencode(str) - para codificar una cadena y hacerla segura para la transmisión HTTP

Parámetros:

! str ****- cadena original

Por ejemplo: John Smith se convierte en John%20Smith, y Anna&Maria se convierte en Anna%26Maria

urldecode(str) - para decodificar una cadena codificada en URL

Parámetros:

! str ****- cadena original

Por ejemplo: John%20Smith se traducirá como John Smith

hmac_hexdigest(secret_key, msg, hash_type) - para aplicar hash a una cadena usando 'sha256', 'md5', 'sha512' o 'sha1'

Parámetros:

! secret_key - clave\ ! msg - cadena a la que se aplicará hash\ ! hash_type - tipo de hash ('sha256', 'md5', 'sha512' o 'sha1')

select_random(str, s) - para seleccionar un elemento aleatorio de una cadena delimitada. El primer parámetro es la cadena con elementos, el segundo es el delimitador. El segundo parámetro por defecto es '|'.

Parámetros:

! str ****- cadena original

! s ****- delimitador de cadena (por defecto es '|')

Ejemplo de uso:
select_random('primer elemento | segundo elemento | otro elemento | y otro más')

tg_escape(str) - para escapar una variable y mostrarla en un mensaje de Telegram con marcado habilitado. La función agrega una barra invertida antes de los siguientes caracteres:
'_', '*', '[', ']', '(', ')', '~', '', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!'

Parámetros:

! str ****- cadena original

Analicemos la función de recorte de cadenas: