SLS string functions syntax and examples - Simple Log Service - Centro de documentación de Alibaba Cloud

Describe la sintaxis, los parámetros y ejemplos de uso de las funciones de cadena en la transformación de datos de SLS.

Funciones

Categoría	Función	Descripción
Operación con varias cadenas	str_format	Formatea cadenas según un formato especificado.
	str_join	Concatena cadenas mediante un conector especificado.
	str_zip	Divide dos valores de expresión y combina los resultados en una sola cadena.
Codificación y decodificación	str_encode	Codifica una cadena con un formato de codificación especificado.
	str_decode	Decodifica un valor de entrada con un formato de codificación especificado.
	str_hex_escape_encode	Escapa caracteres especiales, incluidas secuencias hexadeciales, a su forma legible.
	str_uuid	Genera un UUID aleatorio.
Ordenamiento, inversión y reemplazo	str_sort	Ordena un objeto especificado.
	str_reverse	Invierte una cadena.
	str_replace	Reemplaza una subcadena según una regla especificada.
	str_logstash_config_normalize	Convierte datos del lenguaje de configuración de Logstash al formato JSON.
	str_translate	Reemplaza caracteres en una cadena según una tabla de asignación.
Manipulación básica	str_strip	Elimina caracteres especificados de una cadena.
	str_lstrip	Elimina caracteres especificados del inicio de una cadena.
	str_rstrip	Elimina caracteres especificados del final de una cadena.
	str_lower	Convierte todas las letras mayúsculas a minúsculas.
	str_upper	Convierte todas las letras minúsculas a mayúsculas.
	str_title	Pone en mayúscula la primera letra de cada palabra y en minúscula el resto.
	str_capitalize	Pone en mayúscula la primera letra y en minúscula el resto.
	str_swapcase	Invierte el caso de todas las letras de una cadena.
Búsqueda y comprobación	str_count	Cuenta el número de apariciones de un carácter en una cadena.
	str_find	Comprueba si una cadena contiene una subcadena especificada.
	str_rfind	Devuelve la posición de la última aparición de una subcadena.
	str_endswith	Comprueba si una cadena termina con un sufijo especificado.
	str_startswith	Comprueba si una cadena comienza con un prefijo especificado.
División	str_split	Divide una cadena con un delimitador especificado.
	str_splitlines	Divide una cadena por saltos de línea.
	str_partition	Divide una cadena en tres partes de izquierda a derecha con un delimitador especificado.
	str_rpartition	Divide una cadena en tres partes de derecha a izquierda con un delimitador especificado.
Formato	str_center	Rellena una cadena hasta una longitud especificada con un carácter determinado.
	str_ljust	Rellena una cadena por la derecha hasta una longitud especificada con un carácter determinado.
	str_rjust	Rellena una cadena por la izquierda hasta una longitud especificada con un carácter determinado.
	str_zfill	Rellena una cadena por la izquierda hasta una longitud especificada con ceros.
	str_expandtabs	Convierte el carácter `\t` de una cadena en espacios.
Comprobación de conjunto de caracteres	str_isalnum	Comprueba si una cadena contiene solo letras y dígitos.
	str_isalpha	Comprueba si una cadena contiene solo letras.
	str_isascii	Comprueba si una cadena pertenece a la tabla ASCII.
	str_isdecimal	Comprueba si una cadena contiene solo caracteres decimales.
	str_isdigit	Comprueba si una cadena contiene solo dígitos.
	str_isidentifier	Comprueba si una cadena es un identificador válido de Python.
	str_islower	Comprueba si una cadena contiene solo letras minúsculas.
	str_isnumeric	Comprueba si todos los caracteres de una cadena son numéricos.
	str_isprintable	Comprueba si todos los caracteres de una cadena son imprimibles.
	str_isspace	Comprueba si una cadena contiene solo espacios.
	str_istitle	Comprueba si la primera letra de cada palabra está en mayúscula y el resto en minúscula.
	str_isupper	Comprueba si todas las letras de una cadena están en mayúsculas.

Las funciones de cadena se pueden utilizar junto con las siguientes funciones:

Categoría	Función	Descripción
Operación con varias cadenas	op_add	Devuelve la suma de varios valores numéricos o cadenas.
	op_max	Devuelve el valor máximo entre varios valores numéricos o cadenas.
	op_min	Devuelve el valor mínimo entre varios valores numéricos o cadenas.
Truncamiento de cadenas	op_slice	Trunca una cadena.
Cálculo de longitud	op_len	Devuelve la longitud de una cadena.

str_format

Formatea una cadena según un formato especificado.

Sintaxis

str_format(format_string, value1, value2, ...)

Parámetros

Parámetro	Tipo de datos	Obligatorio	Descripción
format_string	Cualquiera (se convierte automáticamente a cadena)	Sí	El formato de la cadena de salida. Ejemplo: `{}={}`.
value1	Cualquiera	Sí	El valor que se va a formatear.
value2	Cualquiera	Sí	El valor que se va a formatear.

Respuesta

Devuelve una cadena formateada.

Ejemplos

Registro sin procesar
```
class: Format
escape_name: Traditional
```

Regla de transformación

e_set("str_format", str_format("{}={}", v("class"), v("escape_name")))

Resultado

class: Format
escape_name: Traditional
str_format: Format=Traditional

str_join

Combina las cadenas de entrada en una sola cadena separada por un delimitador.

Sintaxis

str_join(connector, value1,  value2, ....)

Parámetros

Parámetro	Tipo de datos	Obligatorio	Descripción
connector	Cualquiera (se convierte automáticamente a cadena)	Sí	El conector. Los conectores compatibles incluyen el signo de exclamación (!), la arroba (@), el signo de número (#), el signo de dólar ($) y el signo de porcentaje (%).
value1	Cualquiera (se convierte automáticamente a cadena)	Sí	El valor que se va a concatenar.
value2	Cualquiera (se convierte automáticamente a cadena)	Sí	El valor que se va a concatenar.

Respuesta

Devuelve una cadena concatenada.

Ejemplos

Registro sin procesar
```
name: ETL
company: aliyun.com
```

Regla de transformación

e_set("email", str_join("@", v("name"), v("company")))

Resultado

name: ETL
company: aliyun.com
email:ETL@aliyun.com

str_encode

Codifica la cadena con el formato de codificación especificado.

Sintaxis

str_encode(value, "utf8", errors="ignore")

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
value	Cualquiera (se convierte automáticamente a cadena)	Sí	El valor que se va a codificar.
encoding	Cadena	No	El formato de codificación. Valor predeterminado: UTF-8. Es compatible con ASCII.
errors	Cadena	No	El método que se utiliza para procesar caracteres cuando no se reconocen según el formato de codificación. Valores válidos: ignore (predeterminado): Los caracteres no se codifican. strict: Se notifica un error y se descarta el registro. replace: Los caracteres no reconocibles se reemplazan por signos de interrogación (?). xmlcharrefreplace: Los caracteres no reconocibles se reemplazan por caracteres XML.

Respuesta

Devuelve una cadena codificada.

Ejemplos

Ejemplo 1

Registro sin procesar
```
test: asewds
```

Regla de transformación

e_set("f1", str_decode(str_encode("Hello", "utf8"), "utf8"))

Resultado
```
test: asewds
f1: Hello
```

Ejemplo 2

Registro sin procesar
```
f2: test Test data
```

Regla de transformación

e_set("f1", str_encode(v("f2"), "ascii", errors="ignore"))

Resultado
```
f1:test 
f2:test Test data
```

Ejemplo 3
- Registro sin procesar
```
f2: test data
```
- Regla de transformación
```
e_set("f1", str_encode(v("f2"), "ascii", errors="strict"))
```
- Resultado
  
  Se notifica un error durante la ejecución.

Ejemplo 4

Registro sin procesar
```
f2: test Test data
```

Regla de transformación

e_set("f1", str_encode(v("f2"), "ascii", errors="replace"))

Resultado
```
f1:test ????
f2:test Test data
```

Ejemplo 5

Registro sin procesar
```
f2: test Test data
```

Regla de transformación

e_set("f1", str_encode(v("f2"), "ascii", errors="xmlcharrefreplace"))

Resultado

f1:test &#27979;&#35797;&#25968;&#25454;
f2:test Test data

str_decode

Decodifica el valor de entrada con el formato de codificación especificado.

Sintaxis
```
str_decode(value, "utf8", errors="ignore")
```
Nota
La función str_decode solo puede procesar datos del tipo byte.

Parámetros

Nombre del parámetro	Tipos de datos	Obligatorio	Descripción
value	Cualquiera (se convierte automáticamente a cadena)	Sí	El valor que se va a decodificar.
encoding	Cualquiera (se convierte automáticamente a cadena)	No	El formato de codificación. Valor predeterminado: UTF-8. Es compatible con ASCII.
errors	Cualquiera (se convierte automáticamente a cadena)	No	El método que se utiliza para procesar caracteres cuando no se reconocen según el formato de codificación. Valores válidos: ignore (predeterminado): Los caracteres no se decodifican. strict: Se notifica un error y se descarta el registro. replace: Los caracteres no reconocibles se reemplazan por signos de interrogación (?). xmlcharrefreplace: Los caracteres no reconocibles se reemplazan por caracteres XML.

Respuesta

Devuelve un valor decodificado.

Ejemplos

Registro sin procesar
```
test: asewds
```

Regla de transformación

e_set("encoding", str_decode(b'\xe4\xbd\xa0\xe5\xa5\xbd', "utf8", 'strict'))

Resultado
```
test: asewds
encoding: Hello
```

str_replace

Reemplaza las apariciones de una subcadena antigua por una nueva.

Sintaxis
```
str_replace(value, old, new, count)
```
Nota
Esta función admite parámetros variables básicos. Function invoking.

Parámetros

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
value	Cualquiera (se convierte automáticamente a cadena)	Sí	El valor donde se realizará el reemplazo.
old	Cualquiera (se convierte automáticamente a cadena)	Sí	La cadena que se va a reemplazar.
new	Cualquiera (se convierte automáticamente a cadena)	Sí	La cadena de reemplazo.
count	Número	No	El número de reemplazos. Si no se especifica, se reemplazan todas las apariciones.

Respuesta

Devuelve una nueva cadena.

Ejemplos

Convertir un diccionario al formato JSON.

Registro sin procesar

content:  {'referer': '-', 'request': 'GET /phpMyAdmin', 'status': 404, 'data-1': {'aaa': 'Mozilla', 'bbb': 'asde'}, 'data-2': {'up_adde': '-', 'up_host': '-'}}

Regla de transformación

e_set("content_json", str_replace(ct_str(v("content")),"'",'"'))

Resultado

content:  {'referer': '-', 'request': 'GET /phpMyAdmin', 'status': 404, 'data-1': {'aaa': 'Mozilla', 'bbb': 'asde'}, 'data-2': {'up_adde': '-', 'up_host': '-'}}
content_json:  {"referer": "-", "request": "GET /phpMyAdmin", "status": 404, "data-1": {"aaa": "Mozilla", "bbb": "asde"}, "data-2": {"up_adde": "-", "up_host": "-"}}

str_sort

Ordena los objetos especificados.

Sintaxis
```
str_sort(value, reverse=False)
```

Parámetros

Nombre del parámetro	Tipo	Obligatorio	Descripción
value	Cualquiera (se convierte automáticamente a cadena)	Sí	La cadena original que se va a ordenar.
reverse	Booleano	No	Valor predeterminado: False, lo que indica que la cadena se ordena en orden ascendente.

Respuesta

Se devuelve una cadena ordenada.
Ejemplos
- Ejemplo 1: Ordenar el valor del campo str en orden alfabético.
  - Registro sin procesar
```
str: twish
```
  - Regla de transformación
```
e_set("str_sort", str_sort(v("str")))
```
  - Resultado
```
str: twish
str_sort: histw
```
- Ejemplo 2: Ordenar la cadena str en orden inverso en grupos de dos.
  - Registro sin procesar
```
str: twish
```
  - Regla de transformación
```
e_set("str_sort", str_sort(v("str"), reverse=True))
```
  - Resultado
```
str: twish
str_sort: wtsih
```

str_reverse

Invierte una cadena.

Sintaxis
```
str_reverse(value)
```
Parámetros

Nombre del parámetro

Tipo

Obligatorio

Descripción

value

Cualquiera (se convierte automáticamente a cadena)

Sí

El valor que se va a invertir.
Respuesta

Devuelve una cadena invertida.
Ejemplos

Invertir el valor del campo data.
- Registro sin procesar
```
data:twish
```
- Regla de transformación
```
e_set("reverse_data", str_reverse(v("data")))
```
- Resultado
```
data:twish
reverse_data:hsiwt
```

str_logstash_config_normalize

Permite convertir una configuración de Logstash al formato JSON.

Sintaxis
```
str_logstash_config_normalize(value)
```
Nota
Para obtener más información sobre el lenguaje de configuración de Logstash, consulte Logstash.
Parámetros

Nombre del parámetro

Tipo

Obligatorio

Descripción

value

Cualquiera (se convierte automáticamente a cadena)

Sí

El valor que se va a convertir.
Respuesta

Devuelve una cadena convertida.

Ejemplos

Transformar datos de Logstash.

Registro sin procesar
```
logstash: {"name"=>"tw5"}
```

Regla de transformación

e_set("normalize_data", str_logstash_config_normalize(v("logstash")))

Resultado

logstash: {"name"=>"tw5"}
normalize_data:{"name":"tw5"}

str_hex_escape_encode

Escapa caracteres especiales y convierte caracteres hexadecimales a caracteres chinos.

Sintaxis
```
str_hex_escape_encode(value)
```
Parámetros

Nombre del parámetro

Tipo

Obligatorio

Descripción

value

Cualquiera (se convierte automáticamente a cadena)

Sí

El valor que se va a escapar.
Respuesta

Devuelve una cadena escapada.

Ejemplos

Escapar el valor del campo myfriend a caracteres chinos.

Registro sin procesar
```
myfriend: \xE6\x9F\xB3\xE4\xBA\x91
```

Regla de transformación

e_set("hex_myfriend", str_hex_escape_encode("myfriend"))

Resultado

hex_myfriend:myfriend
myfriend:\xE6\x9F\xB3\xE4\xBA\x91

str_strip

Elimina los caracteres especificados de una cadena.

Sintaxis
```
str_strip(value, chars)
```

Parámetros

Nombre del parámetro	Tipo de dato	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original que se va a modificar.
chars	Arbitrario (se convierte automáticamente a cadena)	No	El conjunto de caracteres que se eliminarán del inicio y del final de la cadena especificada. Valor predeterminado: `\t\r\n`.

Respuesta

Devuelve una nueva cadena.
Ejemplos
- Ejemplo 1: Eliminar los asteriscos (*) del inicio del valor del campo strip.
  - Registro sin procesar
```
strip: ***I love Etl
```
  - Regla de transformación
```
e_set("str_strip", str_strip(v("strip"), "*"))
```
  - Resultado
```
strip: ***I love Etl
str_strip:I love Etl
```
- Ejemplo 2: Quitar los espacios iniciales.
  - Registro sin procesar
```
strip:    I love Etl
```
  - Regla de transformación
```
e_set("str_strip", str_strip(v("strip")))
```
  - Resultado
```
strip:    I love Etl
str_strip: I love Etl
```
- Ejemplo 3: Eliminar el conjunto de caracteres xy.
  - Registro sin procesar
```
strip:xy123yx
```
  - Regla de transformación
```
e_set("str_strip", str_strip(v("strip"), "xy"))
```
  - Resultado
```
strip:xy123yx
str_strip:123
```

str_lower

Convierte todos los caracteres en mayúsculas de una cadena a minúsculas.

Sintaxis
```
str_lower(value)
```
Parámetros

Parámetro

Tipo

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a convertir.
Respuesta

Devuelve la cadena convertida.
Ejemplos

Convertir el valor del campo name a letras minúsculas.
- Registro sin procesar
```
name: Etl
```
- Regla de transformación
```
e_set("str_lower", str_lower(v("name")))
```
- Resultado
```
name: Etl
str_lower: etl
```

str_upper

Convierte todos los caracteres en minúsculas de una cadena a mayúsculas.

Sintaxis
```
str_upper(value)
```
Parámetros

Parámetro

Tipo de dato

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a convertir.
Respuesta

Devuelve la cadena convertida.
Ejemplos

Convertir el valor del campo name a letras mayúsculas.
- Registro sin procesar
```
name: etl
```
- Regla de transformación
```
e_set("str_upper", str_upper(v("name")))
```
- Resultado
```
name: etl
str_upper: ETL
```

str_title

Pone en mayúscula la primera letra de cada palabra y cambia el resto a minúsculas.

Sintaxis
```
str_title(value)
```
Parámetros

Nombre del parámetro

Tipo de dato

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a convertir.
Respuesta

Devuelve la cadena convertida.
Ejemplos

Poner en mayúscula la primera letra de cada palabra en el valor del campo word.
- Registro sin procesar
```
word: this is etl
```
- Regla de transformación
```
e_set("str_title", str_title(v("word")))
```
- Resultado
```
word: this is etl
str_title: This Is Etl
```

str_capitalize

La función str_capitalize pone en mayúscula la primera letra y convierte el resto a minúsculas.

Sintaxis
```
str_capitalize(value)
```
Parámetros

Parámetro

Tipo

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a convertir.
Respuesta

Devuelve la cadena convertida.
Ejemplos

Poner en mayúscula la primera letra del valor del campo word y convertir las demás letras del valor a minúsculas.
- Registro sin procesar
```
word: this Is MY EAL
```
- Regla de transformación
```
e_set("str_capitalize", str_capitalize(v("word")))
```
- Resultado
```
word: this Is MY EAL
str_capitalize: This is my eal
```

str_lstrip

La función str_lstrip elimina los caracteres especificados del inicio de una cadena.

Sintaxis
```
str_lstrip(value, chars)
```

Parámetros

Nombre del parámetro	Tipo de dato	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original que se va a modificar.
chars	Arbitrario (se convierte automáticamente a cadena)	No	El conjunto de caracteres que se eliminarán del inicio de la cadena. Valor predeterminado: espacio.

Respuesta

Devuelve una nueva cadena.
Ejemplos
- Ejemplo 1: Eliminar los asteriscos (*) del inicio del valor del campo word.
  - Registro sin procesar
```
word: ***this is string
```
  - Regla de transformación
```
e_set("str_lstrip", str_lstrip(v("word"), "*"))
```
  - Resultado
```
word: ***this is string
str_lstrip: this is string
```
- Ejemplo 2: Eliminar los espacios del inicio del valor del campo word.
  - Registro sin procesar
```
word:     this is string
```
  - Regla de transformación
```
e_set("str_lstrip", str_lstrip(v("word")))
```
  - Resultado
```
word:     this is string
str_lstrip: this is string
```
- Ejemplo 3: Eliminar el conjunto de caracteres xy.
  - Registro sin procesar
```
lstrip:xy123yx
```
  - Regla de transformación
```
e_set("str_lstrip", str_lstrip(v("lstrip"),"xy"))
```
  - Resultado
```
lstrip:xy123yx
str_lstrip:123yx
```

str_rstrip

Elimina el carácter final especificado de una cadena.

Sintaxis
```
str_rstrip(value, chars)
```

Parámetros

Nombre del parámetro	Tipo	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original que se va a modificar.
chars	Arbitrario (se convierte automáticamente a cadena)	No	El conjunto de caracteres que se eliminarán del final de la cadena. Valor predeterminado: espacio.

Respuesta

Devuelve una nueva cadena.
Ejemplos
- Ejemplo 1: Eliminar los asteriscos (*) del final del valor del campo word.
  - Registro sin procesar
```
word: this is string*****
```
  - Regla de transformación
```
e_set("str_rstrip", str_rstrip(v("word"), "*"))
```
  - Resultado
```
word: this is string*****
str_rstrip: this is string
```
- Ejemplo 2: Eliminar el conjunto de caracteres xy.
  - Registro sin procesar
```
word:xy123yx
```
  - Regla de transformación
```
e_set("str_rstrip", str_rstrip(v("word"), "xy"))
```
  - Resultado
```
word:xy123yx
str_rstrip:xy123
```

str_swapcase

Permite transformar el uso de mayúsculas y minúsculas de una cadena.

Sintaxis
```
str_swapcase(value)
```
Parámetros

Nombre del parámetro

Tipo

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a convertir.
Respuesta

Devuelve la cadena convertida.

Ejemplos

Registro sin procesar
```
name: this is string
```

Regla de transformación

e_set("str_swapcase", str_swapcase(v("name")))

Resultado

name: this is string
str_swapcase: THIS IS STRING

str_translate

La función str_translate reemplaza caracteres según una tabla de asignación.

Sintaxis

str_translate(value, replace_string, mapping_string)

Parámetros

Nombre del parámetro	Tipos de dato	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original en la que se reemplazarán los caracteres.
replace_string	Arbitrario (se convierte automáticamente a cadena)	Sí	El conjunto de caracteres que se va a reemplazar.
mapping_string	Arbitrario (se convierte automáticamente a cadena)	Sí	El conjunto de caracteres resultante tras el reemplazo.

Respuesta

Devuelve una nueva cadena.

Ejemplos

Registro sin procesar
```
name: I love ETL!!!
```

Regla de transformación

e_set("str_translate", str_translate(v("name"), "aeiou", "12345"))

Resultado

name: I love ETL!!!
str_translate: I l4v2 ETL!!!

str_endswith

La función str_endswith comprueba si una cadena termina con un sufijo especificado.

Sintaxis
```
str_endswith(value, suffix, start, end)
```
Nota
Esta función admite parámetros variables básicos. Function invoking.

Parámetros

Nombre del parámetro	Tipo	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original que se va a comprobar.
suffix	Arbitrario (se convierte automáticamente a cadena)	Sí	El sufijo. El valor de este parámetro puede ser una cadena o un elemento.
start	Number	No	La posición desde la que comienza la comprobación. El valor 0 indica el primer carácter. El valor -1 indica el último carácter.
end	Number	No	La posición en la que termina la comprobación. El valor 0 indica el primer carácter. El valor -1 indica el último carácter.

Respuesta

Si la cadena termina con el sufijo especificado, se devuelve True. De lo contrario, se devuelve False.

Ejemplos

Registro sin procesar
```
name: this is endswith!!!
```

Regla de transformación

e_set("str_endswith",str_endswith(v("name"), "!"))

Resultado

name: this is endswith!!!
str_endswith: True

str_startswith

La función str_startswith comprueba si una cadena comienza con un prefijo especificado.

Sintaxis
```
str_startswith(value, prefix, start, end)
```
Nota
Esta función admite parámetros variables básicos. Function invoking.

Parámetros

Nombre del parámetro	Tipo	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original que se va a comprobar.
prefix	Arbitrario (se convierte automáticamente a cadena)	Sí	El prefijo. El valor de este parámetro puede ser una cadena o un elemento.
start	Number	No	La posición desde la que comienza la comprobación. El valor 0 indica el primer carácter. El valor -1 indica el último carácter.
end	Number	No	La posición en la que termina la comprobación. El valor 0 indica el primer carácter. El valor -1 indica el último carácter.

Respuesta

Si la cadena comienza con el prefijo especificado, se devuelve True. De lo contrario, se devuelve False.

Ejemplos

Registro sin procesar
```
name: !! this is startwith
```

Regla de transformación

e_set("str_startswith",str_startswith(v("name"), "!!"))

Resultado

name: !! this is startwith
str_startswith: True

str_find

Comprueba si la cadena de origen contiene la subcadena especificada.

Sintaxis
```
str_find(value, str, begin, end)
```
Nota
Esta función admite parámetros variables básicos. Function invoking.

Parámetros

Nombre del parámetro	Tipo	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original en la que se buscará una subcadena.
str	Arbitrario (se convierte automáticamente a cadena)	Sí	La subcadena que se va a buscar.
begin	Number	No	La posición desde la que comienza la búsqueda. El valor predeterminado 0 indica el primer carácter. El valor -1 indica el último carácter.
end	Number	No	La posición final del índice. El valor predeterminado es la longitud de la cadena. El valor 0 indica el primer carácter. El valor -1 indica el último carácter.

Respuesta

Devuelve la posición de la primera aparición de la subcadena especificada.

Ejemplos

Registro sin procesar
```
name: hello world
```

Regla de transformación

e_set("str_find",str_find(v("name"), "h"))

Resultado
```
name: hello world
str_find: 0
```

str_count

La función str_count cuenta las apariciones de caracteres en una cadena.

Sintaxis
```
str_count(value, sub, start, end)
```
Nota
Esta función admite parámetros variables básicos. Function invoking.

Parámetros

Nombre del parámetro	Tipo de dato	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena de origen para el conteo.
sub	Arbitrario (se convierte automáticamente a cadena)	Sí	El carácter cuyo número de apariciones desea contar.
start	Number	No	La posición desde la que comienza la búsqueda del carácter especificado en la cadena. Valores válidos: 0 (predeterminado): el primer carácter -1: el último carácter
end	Number	No	La posición en la que termina la búsqueda del carácter especificado en la cadena. Valores válidos: 0: el primer carácter -1 (predeterminado): el último carácter

Respuesta

Devuelve el número de apariciones del carácter especificado.

Ejemplos

Registro sin procesar
```
name: this is really a string
```

Regla de transformación

e_set("str_count", str_count(v("name"), "i"))

Resultado

name: this is really a string
str_count: 3

str_rfind

La función str_rfind devuelve la posición de la última aparición de una subcadena.

Sintaxis
```
str_rfind(value, substr, beg, end)
```
Nota
Esta función admite parámetros variables básicos. Function invoking.

Parámetros

Nombre del parámetro	Tipo de dato	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena de origen donde se realizará la búsqueda.
substr	Arbitrario (se convierte automáticamente a cadena)	Sí	El carácter que se va a buscar.
beg	Number	No	La posición desde la que comienza la búsqueda. Valor predeterminado: 0.
end	Number	No	La posición en la que termina la búsqueda. El valor predeterminado es la longitud de la cadena.

Respuesta

Devuelve la posición de la última aparición del carácter o la cadena especificados.

Ejemplos

Registro sin procesar
```
name: this is really a string
```

Regla de transformación

e_set("str_rfind", str_rfind(v("name"), "i"))

Resultado

name: this is really a string
str_rfind: 20

str_split

Divide una cadena en subcadenas según un separador especificado.

Sintaxis
```
str_split(value, sep=None, maxsplit=-1)
```

Parámetros

Nombre del parámetro	Tipos de dato	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original que se va a dividir.
sep	Number	No	El delimitador. El valor None indica un espacio.
maxsplit	Number	No	El número máximo de subcadenas en las que se puede dividir la cadena. El valor -1 indica que no hay límite.

Respuesta

Se devuelven las cadenas procesadas.
Ejemplos

Dividir el valor del campo content mediante el delimitador de espacio.
- Registro sin procesar
```
content: hello world
```
- Regla de transformación
```
e_set("str_split", str_split(v("content"), " "))
```
- Resultado
```
content: hello world
str_split: ["hello", "world"]
```

str_splitlines

Permite dividir una cadena por saltos de línea.

Sintaxis
```
str_splitlines(value, keepends)
```

Parámetros

Nombre del parámetro	Tipo de dato	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original que se va a dividir.
keepends	Boolean	No	Especifica si se conservan los saltos de línea en el resultado. Los saltos de línea incluyen `\r`, `\r\n` y `\n`. Valor predeterminado: False, que indica que los saltos de línea se eliminan. El valor True indica que los saltos de línea se conservan.

Respuesta

Devuelve la lista procesada.

Ejemplos

Ejemplo 1

Registro sin procesar
```
content: ab c\n\nde fg\rkl\r\n
```

Regla de transformación

e_set("str_splitlines", str_splitlines(v("content"), False))

Resultado

content: ab c\n\nde fg\rkl\r\n
str_splitlines: ['ab c', '', 'de fg', 'kl']

Ejemplo 2

Registro sin procesar
```
content: ab c\n\nde fg\rkl\r\n
```

Regla de transformación

e_set("str_splitlines", str_splitlines(v("content"), True))

Resultado

content: ab c\n\nde fg\rkl\r\n  
str_splitlines: ['ab c\n', '\n', 'de fg\r', 'kl\r\n']

str_partition

La función str_partition divide una cadena en tres partes de izquierda a derecha mediante un delimitador especificado.

Sintaxis
```
str_partition(value, substr)
```

Parámetros

Parámetro	Tipos de dato	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena que se va a dividir.
substr	Arbitrario (se convierte automáticamente a cadena)	No	El delimitador.

Respuesta

Se devuelve la lista dividida.
Ejemplos

Dividir el valor del campo website en tres partes de izquierda a derecha mediante el delimitador ..
- Registro sin procesar
```
website: www.aliyun.com
```
- Regla de transformación
```
e_set("str_partition", str_partition(v("website"), "."))
```
- Resultado
```
website: www.aliyun.com
str_partition:  ["www", ".", "aliyun.com"]
```

str_rpartition

La función str_rpartition divide una cadena en tres partes de derecha a izquierda mediante un delimitador especificado.

Sintaxis
```
str_rpartition(value, substr)
```

Parámetros

Nombre del parámetro	Tipo	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original que se va a dividir.
substr	Arbitrario (se convierte automáticamente a cadena)	No	El delimitador.

Respuesta

Devuelve la lista procesada.
Ejemplos

Dividir el valor del campo website en tres partes de derecha a izquierda mediante el delimitador ..
- Registro sin procesar
```
website: www.aliyun.com
```
- Regla de transformación
```
e_set("str_partition", str_rpartition(v("website"), "."))
```
- Resultado
```
  website: www.aliyun.com
  str_partition: ["www.aliyun", ".", "com"]
```

str_center

Rellena una cadena hasta alcanzar una longitud especificada con un carácter determinado.

Sintaxis
```
str_center(value, width, fillchar)
```

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original que se va a modificar.
width	Number	Sí	La longitud de la cadena después del relleno.
fillchar	Arbitrario (se convierte automáticamente a cadena)	No	El carácter que se usa para el relleno. Valor predeterminado: espacio.

Respuesta

Devuelve una nueva cadena.

Nota
Si la longitud de la nueva cadena tras el relleno es menor que la longitud de la cadena original, se devuelve la cadena original.

Ejemplos

Ejemplo 1: Rellenar una cadena con asteriscos (*).

Registro sin procesar
```
center: this is center
```

Regla de transformación

e_set("str_center", str_center(v("center"), 40, "*"))

Resultado

center: this is center
str_center: *************this is center*************

Ejemplo 2: Rellenar una cadena con espacios.

Registro sin procesar
```
center: this is center
```

Regla de transformación

e_set("str_center", str_center(v("center"), 40))

Resultado

center: this is center
str_center:              this is center

str_zfill

La función str_zfill rellena una cadena con ceros a la izquierda hasta alcanzar la longitud especificada.

Sintaxis
```
str_zfill(value, width)
```

Parámetros

Nombre del parámetro	Tipo de dato	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original que se va a modificar.
width	Número	Sí	La longitud de la cadena después del relleno.

Respuesta

Devuelve una nueva cadena.

Ejemplos

Registro sin procesar
```
center: this is zfill
```

Regla de transformación

e_set("str_zfill", str_zfill(v("center"), 40))

Resultado

center:this is zfill
str_zfill:000000000000000000000000000this is zfill

str_expandtabs

Reemplace \t en una cadena por un espacio.

Sintaxis
```
str_expandtabs(value, tabsize)
```

Parámetros

Nombre del parámetro	Tipo	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original que se va a modificar.
tabsize	Número	Sí	El número de espacios después de la conversión.

Respuesta

Devuelve una nueva cadena.

Ejemplos

Ejemplo 1: Convierta \t en el valor del campo logstash a espacios.

Registro sin procesar
```
logstash: this is\tstring
```

Regla de transformación

e_set("str_expandtabs", str_expandtabs(v("logstash")))

Resultado

logstash: this is\tstring
str_expandtabs: this is string

Ejemplo 2: Convierta \t en el valor del campo center a espacios.

Registro sin procesar
```
{"center": "this is\tstring"}
```

Regla de transformación

e_set("str_expandtabs", str_expandtabs(v("center"), 16))

Resultado

center: this is\tstring
str_expandtabs: this is         string

str_ljust

La función str_ljust rellena una cadena a la derecha hasta alcanzar la longitud especificada mediante un carácter determinado.

Sintaxis
```
str_ljust(value, width, fillchar)
```

Parámetros

Nombre del parámetro	Tipo	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original que se va a modificar.
width	Número	Sí	La longitud de la cadena después del relleno.
fillchar	Arbitrario (se convierte automáticamente a cadena)	No	El carácter que se utiliza para el relleno. Valor predeterminado: espacio.

Respuesta

Devuelve una nueva cadena.

Nota
Si la longitud de la nueva cadena tras el relleno es menor que la de la cadena original, se devuelve la cadena original.

Ejemplos

Ejemplo 1

Registro sin procesar
```
content: this is ljust
```

Regla de transformación

e_set("str_ljust", str_ljust(v("content"), 20, "*"))

Resultado

content: this is ljust
str_ljust: this is ljust*******

Ejemplo 2

Registro sin procesar
```
center: this is ljust
```

Regla de transformación

e_set("str_ljust", str_ljust(v("center"), 20,))

Resultado

center: this is ljust
str_ljust: this is ljust

Ejemplo 3: Si el ancho es menor o igual a la longitud de la cadena, la función devuelve la cadena original.
- Registro sin procesar
```
center: this is ljust
```
- Regla de transformación
```
e_set("str_ljust", str_ljust(v("center"),10,  "*"))
```
- Resultado
```
center: this is ljust
str_ljust: this is ljust
```

str_rjust

La función str_rjust rellena una cadena a la izquierda hasta alcanzar la longitud especificada mediante un carácter determinado.

Sintaxis
```
str_rjust(value, width, fillchar)
```

Parámetros

Parámetro	Tipos de dato	Obligatorio	Descripción
value	Arbitrario (se convierte automáticamente a cadena)	Sí	La cadena original que se va a modificar.
width	Número	Sí	La longitud de la cadena después del relleno.
fillchar	Arbitrario (se convierte automáticamente a cadena)	No	El carácter que se utiliza para el relleno. Valor predeterminado: espacio.

Respuesta

Devuelve una nueva cadena.

Nota
Si la longitud de la nueva cadena tras el relleno es menor que la de la cadena original, se devuelve la cadena original.

Ejemplos

Registro sin procesar
```
center: this is rjust
```

Regla de transformación

e_set("str_rjust", str_rjust(v("center"), 20, "*"))

Resultado

center: this is rjust
str_rjust: *******this is rjust

str_zip

Divide dos valores de cadena o expresiones y combina los resultados en una sola cadena.

Sintaxis

str_zip(value1, value2, combine_sep=None, sep=None, quote=None, lparse=None, rparse=None)

Parámetros

Nombre del parámetro	Tipo	Obligatorio	Descripción
value1	Arbitrario (se convierte automáticamente a cadena)	Sí	El valor que se va a combinar.
value2	Arbitrario (se convierte automáticamente a cadena)	Sí	El valor que se va a combinar.
combine_sep	Arbitrario (se convierte automáticamente a cadena)	No	El identificador que se usa para combinar los elementos. Valor predeterminado: `#`.
sep	Arbitrario (se convierte automáticamente a cadena)	No	El delimitador que se usa entre los elementos después de combinarlos. El valor debe ser un solo carácter. Valor predeterminado: `,`.
quote	Arbitrario (se convierte automáticamente a cadena)	No	El carácter que se usa para encerrar los elementos después de combinarlos. Este parámetro es obligatorio si los valores contienen delimitadores. Valor predeterminado: `"`.
lparse	Arbitrario (se convierte automáticamente a cadena)	No	El delimitador y las comillas que se usan entre los elementos de `value1`. Delimitador predeterminado: `,`. Comillas predeterminadas: `"`. Formato: `lparse=(',', '"')`. Nota Las comillas tienen mayor prioridad que el delimitador.
rparse	Arbitrario (se convierte automáticamente a cadena)	No	El delimitador y las comillas que se usan entre los elementos de `value2`. Delimitador predeterminado: `,`. Comillas predeterminadas: `"`. Formato: `rparse=(',', '"')`. Nota Las comillas tienen mayor prioridad que el delimitador.

Respuesta

Se devuelve una cadena combinada.

Ejemplos

Ejemplo 1

Registro sin procesar
```
website: wwww.aliyun.com
escape_name: o
```

Regla de transformación

e_set("combine", str_zip(v("website"), v("escape_name"), combine_sep="@"))

Resultado

website: wwww.aliyun.com
escape_name: o
combine: wwww.aliyun.com@o

Ejemplo 2

Registro sin procesar
```
website: wwww.aliyun.com
escape_name: o
```

Regla de transformación

e_set("combine", str_zip(v("website"), v("escape_name")))

Resultado

combine:wwww.aliyun.com#o  
escape_name:o
website:wwww.aliyun.com

Ejemplo 3: Uso del parámetro sep.

Registro sin procesar
```
f1: a,b,c
f2: x,y,z
```

Regla de transformación

e_set("combine", str_zip(v("f1"), v("f2"), sep="|"))

Resultado

f1: a,b,c
f2: x,y,z
combine: a#x|b#y|c#z

Ejemplo 4: Uso del parámetro quote.

Registro sin procesar
```
f1: "a,a", b, "c,c"
f2: x, "y,y", z
```

Regla de transformación

e_set("combine", str_zip(v("f1"), v("f2"), quote='|'))

Resultado

f1: "a,a", b, "c,c"
f2: x, "y,y", z
combine: |a,a#x|,|b#y,y|,|c,c#z|

Ejemplo 5: Uso de valores de campo con longitudes diferentes.
- Registro sin procesar
```
f1: a,b
f2: x,y,z
```
- Regla de transformación
```
e_set("combine", str_zip(v("f1"), v("f2")))
```
- Resultado
```
f1: a,b
f2: x,y,z
combine: a#x,b#y
```

Ejemplo 6: Uso de los parámetros lparse y rparse.

Registro sin procesar
```
f1: a#b#c
f2: x|y|z
```

Regla de transformación

e_set("combine", str_zip(v("f1"), v("f2"), lparse=("#", '"'), rparse=("|", '"')))

Resultado

f1: a#b#c
f2: x|y|z
combine: a#x,b#y,c#z

Ejemplo 7: Uso de los parámetros lparse y rparse.

Registro sin procesar
```
f1: |a,a|, b, |c,c|
f2: x, #y,y#, z
```

Regla de transformación

e_set("combine", str_zip(v("f1"), v("f2"), lparse=(",", '|'), rparse=(",", '#')))

Resultado

f1: |a,a|, b, |c,c|
f2: x, #y,y#, z
combine: "a,a#x","b#y,y","c,c#z"

str_isalnum

Comprueba si una cadena es alfanumérica.

Sintaxis
```
str_isalnum(value)
```
Parámetros

Nombre del parámetro

Tipo

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a comprobar.
Respuesta

Se devuelve el valor True o False.

Ejemplos

Registro sin procesar
```
content: 13
```

Regla de transformación

e_set("str_isalnum", str_isalnum(v("content")))

Resultado
```
content: 13
str_isalnum: True
```

str_isalpha

Comprueba si una cadena consta únicamente de letras.

Sintaxis
```
str_isalpha(value)
```
Parámetros

Parámetro

Tipo

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a comprobar.
Respuesta

Se devuelve el valor True o False.

Ejemplos

Registro sin procesar
```
content: 13
```

Regla de transformación

e_set("str_isalpha", str_isalpha(v("content")))

Resultado
```
content: 13
str_isalpha: False
```

str_isascii

Determina si la cadena es ASCII.

Sintaxis
```
str_isascii(value)
```
Parámetros

Nombre del parámetro

Tipo

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a comprobar.
Respuesta

Se devuelve el valor True o False.

Ejemplos

Registro sin procesar
```
content: asw123
```

Regla de transformación

e_set("str_isascii", str_isascii(v("content")))

Resultado
```
content: asw123
str_isascii: True
```

str_isdecimal

Comprueba si una cadena contiene únicamente caracteres decimales.

Sintaxis
```
str_isdecimal(value)
```
Parámetros

Nombre del parámetro

Tipo

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a comprobar.
Respuesta

Se devuelve el valor True o False.

Ejemplos

Ejemplo 1

Registro sin procesar
```
welcome: Hello
```

Regla de transformación

e_set("str_isdecimal", str_isdecimal(v("welcome")))

Resultado
```
welcome: Hello
str_isdecimal: False
```

Ejemplo 2

Registro sin procesar
```
num: 123
```

Regla de transformación

e_set("str_isdecimal", str_isdecimal(v("num")))

Resultado
```
num: 123
str_isdecimal: True
```

str_isdigit

Comprueba si una cadena contiene únicamente dígitos.

Sintaxis
```
str_isdigit(value)
```
Parámetros

Nombre del parámetro

Tipo de dato

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a comprobar.
Respuesta

Se devuelve el valor True o False.

Ejemplos

Registro sin procesar
```
content: 13
```

Regla de transformación

e_set("str_isdigit", str_isdigit(v("content")))

Resultado
```
content: 13
str_isdigit: True
```

str_isidentifier

Determina si una cadena es un identificador de Python válido.

Sintaxis
```
str_isidentifier(value)
```
Parámetros

Nombre del parámetro

Tipo de dato

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a comprobar.
Respuesta

Se devuelve el valor True o False.

Ejemplos

Registro sin procesar
```
class: class
```

Regla de transformación

e_set("str_isidentifier", str_isidentifier(v("class")))

Resultado
```
class: class
str_isidentifier: True
```

str_islower

Comprueba si una cadena contiene únicamente letras minúsculas.

Sintaxis
```
str_islower(value)
```
Parámetros

Parámetro

Tipo

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a comprobar.
Respuesta

Se devuelve el valor True o False.

Ejemplos

Registro sin procesar
```
lower: asds
```

Regla de transformación

e_set("str_islower", str_islower(v("lower")))

Resultado
```
lower: asds
str_islower: True
```

str_isnumeric

Compruebe si una cadena contiene únicamente dígitos.

Sintaxis
```
str_isnumeric(value)
```
Parámetros

Parámetro

Tipo de dato

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a comprobar.
Respuesta

Se devuelve el valor True o False.

Ejemplos

Registro sin procesar
```
num: 123
```

Regla de transformación

e_set("str_isnumeric", str_isnumeric(v("num")))

Resultado
```
num: 123
str_isnumeric: True
```

str_isprintable

La función str_isprintable comprueba si todos los caracteres de una cadena son imprimibles.

Sintaxis
```
str_isprintable(value)
```
Parámetros

Nombre del parámetro

Tipo

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a comprobar.
Respuesta

Se devuelve el valor True o False.

Ejemplos

Registro sin procesar
```
content: vs;,.as
```

Regla de transformación

e_set("str_isprintable",  str_isprintable(v("content")))

Resultado
```
content: vs;,.as
str_isprintable: True
```

str_isspace

Determina si una cadena consta únicamente de caracteres de espacio.

Sintaxis
```
str_isspace(value)
```
Parámetros

Nombre del parámetro

Tipo

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a comprobar.
Respuesta

Se devuelve el valor True o False.

Ejemplos

Registro sin procesar
```
space:  as afsd
```

Regla de transformación

e_set("str_isspace", str_isspace(v("space")))

Resultado
```
space:  as afsd
str_isspace: False
```

str_istitle

Comprueba si la primera letra de cada palabra en una cadena está en mayúscula y las letras restantes están en minúscula.

Sintaxis
```
str_istitle(value)
```
Parámetros

Parámetro

Tipo de dato

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a comprobar.
Respuesta

Se devuelve el valor True o False.

Ejemplos

Registro sin procesar
```
title: Alex Is A Boy
```

Regla de transformación

e_set("str_istitle", str_istitle(v("title")))

Resultado
```
str_istitle:true
title:Alex Is A Boy
```

str_isupper

Comprueba si todas las letras de la cadena están en mayúsculas.

Sintaxis
```
str_isupper(value)
```
Parámetros

Nombre del parámetro

Tipo de dato

Obligatorio

Descripción

value

Arbitrario (se convierte automáticamente a cadena)

Sí

La cadena que se va a comprobar.
Respuesta

Se devuelve el valor True o False.

Ejemplos

Registro sin procesar
```
content: ASSD
```

Regla de transformación

e_set("str_isupper", str_isupper(v("content")))

Resultado
```
content: ASSD
str_isupper: True
```

str_uuid

Genera un UUID aleatorio.

Sintaxis
```
str_uuid(lower=True)
```

Parámetros

Nombre del parámetro	Tipo	Obligatorio	Descripción
lower	Booleano	No	Especifica si las letras del UUID de salida están en minúsculas. Valor predeterminado: True, lo que indica que las letras están en minúsculas.

Respuesta

Se devuelve un UUID.

Ejemplos

Ejemplo 1

Registro sin procesar
```
content: I am Iron man
```
Regla de transformación
```
e_set("UUID", str_uuid())
```

Resultado

content: I am Iron man
UUID: e9fcd6b0-b970-11ec-979d-0f7041e65ab8

Ejemplo 2

Registro sin procesar
```
content: I am Iron man
```
Regla de transformación
```
e_set("UUID", str_uuid(lower=False))
```

Resultado

content: I am Iron man
UUID: 0649211E-B971-11EC-A258-E71F0A2930C5