Sintaxe e exemplos de funções de string do SLS - Simple Log Service: Central de Documentação do Alibaba Cloud

Funções

Categoria	Função	Descrição
Operação com múltiplas strings	str_format	Formata strings conforme um formato especificado.
	str_join	Concatena strings usando um conector especificado.
	str_zip	Divide dois valores de expressão e combina os resultados em uma única string.
Codificação e decodificação	str_encode	Codifica uma string usando um formato de codificação especificado.
	str_decode	Decodifica um valor de entrada usando um formato de codificação especificado.
	str_hex_escape_encode	Aplica escape em caracteres especiais, incluindo sequências hexadecais, para sua forma legível.
	str_uuid	Gera um UUID aleatório.
Ordenação, inversão e substituição	str_sort	Ordena um objeto especificado.
	str_reverse	Inverte uma string.
	str_replace	Substitui uma substring com base em uma regra especificada.
	str_logstash_config_normalize	Converte dados na linguagem de configuração do Logstash para o formato JSON.
	str_translate	Substitui caracteres em uma string com base em uma tabela de mapeamento.
Manipulação regular	str_strip	Remove caracteres especificados de uma string.
	str_lstrip	Remove caracteres especificados do início de uma string.
	str_rstrip	Remove caracteres especificados do final de uma string.
	str_lower	Converte todas as letras maiúsculas em minúsculas.
	str_upper	Converte todas as letras minúsculas em maiúsculas.
	str_title	Coloca a primeira letra de cada palavra em maiúscula e as demais em minúscula.
	str_capitalize	Coloca a primeira letra em maiúscula e as demais em minúscula.
	str_swapcase	Inverte a caixa de todas as letras em uma string.
Busca e verificação	str_count	Conta o número de ocorrências de um caractere em uma string.
	str_find	Verifica se uma string contém uma substring especificada.
	str_rfind	Retorna a posição da última ocorrência de uma substring.
	str_endswith	Verifica se uma string termina com um sufixo especificado.
	str_startswith	Verifica se uma string começa com um prefixo especificado.
Divisão	str_split	Divide uma string usando um delimitador especificado.
	str_splitlines	Divide uma string usando quebras de linha.
	str_partition	Divide uma string em três partes, da esquerda para a direita, usando um delimitador especificado.
	str_rpartition	Divide uma string em três partes, da direita para a esquerda, usando um delimitador especificado.
Formatação	str_center	Preenche uma string até um comprimento especificado usando um caractere definido.
	str_ljust	Preenche uma string à direita até um comprimento especificado usando um caractere definido.
	str_rjust	Preenche uma string à esquerda até um comprimento especificado usando um caractere definido.
	str_zfill	Preenche uma string à esquerda até um comprimento especificado usando o caractere 0.
	str_expandtabs	Converte o caractere `\t` em uma string para espaços.
Verificação de conjunto de caracteres	str_isalnum	Verifica se uma string contém apenas letras e dígitos.
	str_isalpha	Verifica se uma string contém apenas letras.
	str_isascii	Verifica se uma string está na tabela ASCII.
	str_isdecimal	Verifica se uma string contém apenas caracteres decimais.
	str_isdigit	Verifica se uma string contém apenas dígitos.
	str_isidentifier	Verifica se uma string é um identificador Python válido.
	str_islower	Verifica se uma string contém apenas letras minúsculas.
	str_isnumeric	Verifica se todos os caracteres de uma string são numéricos.
	str_isprintable	Verifica se todos os caracteres de uma string são imprimíveis.
	str_isspace	Verifica se uma string contém apenas espaços.
	str_istitle	Verifica se a primeira letra de cada palavra em uma string é maiúscula e as demais letras são minúsculas.
	str_isupper	Verifica se todas as letras de uma string são maiúsculas.

É possível utilizar funções de string em conjunto com as seguintes funções:

Categoria	Função	Descrição
Operação com múltiplas strings	op_add	Retorna a soma de múltiplos valores numéricos ou strings.
	op_max	Retorna o valor máximo entre múltiplos valores numéricos ou strings.
	op_min	Retorna o valor mínimo entre múltiplos valores numéricos ou strings.
Truncamento de string	op_slice	Trunca uma string.
Cálculo de comprimento	op_len	Retorna o comprimento de uma string.

str_format

Formata uma string usando um formato especificado.

Sintaxe

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

Parâmetros

Parâmetro	Tipo de dados	Obrigatório	Descrição
format_string	Arbitrário (convertido automaticamente para string)	Sim	O formato da string de saída. Exemplo: `{}={}`.
value1	Arbitrário	Sim	O valor a ser formatado.
value2	Arbitrário	Sim	O valor a ser formatado.

Resposta

Retorna uma string formatada.

Exemplos

Log bruto
```
class: Format
escape_name: Traditional
```

Regra de transformação

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

Resultado

class: Format
escape_name: Traditional
str_format: Format=Traditional

str_join

Combina as strings de entrada em uma única string separada por um delimitador.

Sintaxe

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

Parâmetros

Parâmetro	Tipo de dados	Obrigatório	Descrição
connector	Arbitrário (convertido automaticamente para string)	Sim	O conector. Os conectores suportados incluem ponto de exclamação (!), arroba (@), cerquilha (#), cifrão ($) e sinal de porcentagem (%).
value1	Arbitrário (convertido automaticamente para string)	Sim	O valor a ser concatenado.
value2	Arbitrário (convertido automaticamente para string)	Sim	O valor a ser concatenado.

Resposta

Retorna uma string concatenada.

Exemplos

Log bruto
```
name: ETL
company: aliyun.com
```

Regra de transformação

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

Resultado

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

str_encode

Codifica a string usando o formato de codificação especificado.

Sintaxe

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

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	O valor a ser codificado.
encoding	String	Não	O formato de codificação. Valor padrão: UTF-8. ASCII é suportado.
errors	String	Não	O método usado para processar caracteres caso não sejam reconhecidos pelo formato de codificação. Valores válidos: ignore (padrão): Os caracteres não são codificados. strict: Um erro é reportado e o log é descartado. replace: Os caracteres irreconhecíveis são substituídos por pontos de interrogação (?). xmlcharrefreplace: Os caracteres irreconhecíveis são substituídos por caracteres XML.

Resposta

Retorna uma string codificada.

Exemplos

Exemplo 1

Log bruto
```
test: asewds
```

Regra de transformação

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

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

Exemplo 2

Log bruto
```
f2: test Test data
```

Regra de transformação

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

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

Exemplo 3
- Log bruto
```
f2: test data
```
- Regra de transformação
```
e_set("f1", str_encode(v("f2"), "ascii", errors="strict"))
```
- Resultado
  
  Um erro é reportado durante a execução.

Exemplo 4

Log bruto
```
f2: test Test data
```

Regra de transformação

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

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

Exemplo 5

Log bruto
```
f2: test Test data
```

Regra de transformação

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

Resultado

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

str_decode

Decodifica o valor de entrada usando o formato de codificação especificado.

Sintaxe
```
str_decode(value, "utf8", errors="ignore")
```
Nota
A função str_decode processa apenas dados do tipo byte.

Parâmetros

Nome do parâmetro	Tipos de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	O valor a ser decodificado.
encoding	Arbitrário (convertido automaticamente para string)	Não	O formato de codificação. Valor padrão: UTF-8. ASCII é suportado.
errors	Arbitrário (convertido automaticamente para string)	Não	O método usado para processar caracteres caso não sejam reconhecidos pelo formato de codificação. Valores válidos: ignore (padrão): Os caracteres não são decodificados. strict: Um erro é reportado e o log é descartado. replace: Os caracteres irreconhecíveis são substituídos por pontos de interrogação (?). xmlcharrefreplace: Os caracteres irreconhecíveis são substituídos por caracteres XML.

Resposta

Retorna um valor decodificado.

Exemplos

Log bruto
```
test: asewds
```

Regra de transformação

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

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

str_replace

Substitui ocorrências de uma substring antiga por uma nova substring.

Sintaxe
```
str_replace(value, old, new, count)
```
Nota
Esta função suporta parâmetros variáveis básicos. Invocação de função.

Parâmetros

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	O valor a ser substituído.
old	Arbitrário (convertido automaticamente para string)	Sim	A string que será substituída.
new	Arbitrário (convertido automaticamente para string)	Sim	A string resultante após a substituição.
count	Número	Não	Quantidade de substituições a realizar. Se não especificado, todas as ocorrências serão substituídas.

Resposta

Retorna uma nova string.

Exemplos

Converta um dicionário para o formato JSON.

Log bruto

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

Regra de transformação

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 os objetos especificados.

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

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string original a ser ordenada.
reverse	Booleano	Não	Valor padrão: False, indicando que a string é ordenada em ordem crescente.

Resposta

Retorna uma string ordenada.
Exemplos
- Exemplo 1: Ordene o valor do campo str em ordem alfabética.
  - Log bruto
```
str: twish
```
  - Regra de transformação
```
e_set("str_sort", str_sort(v("str")))
```
  - Resultado
```
str: twish
str_sort: histw
```
- Exemplo 2: Ordene a string str em ordem inversa.
  - Log bruto
```
str: twish
```
  - Regra de transformação
```
e_set("str_sort", str_sort(v("str"), reverse=True))
```
  - Resultado
```
str: twish
str_sort: wtsih
```

str_reverse

Inverte uma string.

Sintaxe
```
str_reverse(value)
```

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	O valor a ser invertido.

Resposta

Retorna uma string invertida.

Exemplos

Inverta o valor do campo data.

Log bruto
```
data:twish
```

Regra de transformação

e_set("reverse_data", str_reverse(v("data")))

Resultado
```
data:twish
reverse_data:hsiwt
```

str_logstash_config_normalize

Converte uma configuração do Logstash para o formato JSON.

Sintaxe
```
str_logstash_config_normalize(value)
```
Nota
Para detalhes sobre a linguagem de configuração do Logstash, consulte Logstash.

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	O valor a ser convertido.

Resposta

Retorna uma string convertida.

Exemplos

Transforme dados do Logstash.

Log bruto
```
logstash: {"name"=>"tw5"}
```

Regra de transformação

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

Resultado

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

str_hex_escape_encode

Aplica escape em caracteres especiais e converte caracteres hexadecimais em caracteres chineses.

Sintaxe
```
str_hex_escape_encode(value)
```

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	O valor a receber escape.

Resposta

Retorna uma string com escape aplicado.

Exemplos

Aplique escape no valor do campo myfriend para converter em caracteres chineses.

Log bruto
```
myfriend: \xE6\x9F\xB3\xE4\xBA\x91
```

Regra de transformação

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

Resultado

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

str_strip

Remove caracteres especificados de uma string.

Sintaxe
```
str_strip(value, chars)
```

Parâmetros

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string original a ser modificada.
chars	Arbitrário (convertido automaticamente para string)	Não	Conjunto de caracteres a excluir do início e do fim da string especificada. Valor padrão: `\t\r\n`.

Resposta

Retorna uma nova string.

Exemplos

Exemplo 1: Exclua os asteriscos (*) do início do valor do campo strip.
- Log bruto
```
strip: ***I love Etl
```
- Regra de transformação
```
e_set("str_strip", str_strip(v("strip"), "*"))
```
- Resultado
```
strip: ***I love Etl
str_strip:I love Etl
```

Exemplo 2: Remova os espaços à esquerda.

Log bruto
```
strip:    I love Etl
```

Regra de transformação

e_set("str_strip", str_strip(v("strip")))

Resultado

strip:    I love Etl
str_strip: I love Etl

Exemplo 3: Exclua o conjunto de caracteres xy.

Log bruto
```
strip:xy123yx
```

Regra de transformação

e_set("str_strip", str_strip(v("strip"), "xy"))

Resultado
```
strip:xy123yx
str_strip:123
```

str_lower

Converte todos os caracteres maiúsculos de uma string para minúsculos.

Sintaxe
```
str_lower(value)
```

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser convertida.

Resposta

Retorna uma string convertida.
Exemplos

Converta o valor do campo name para letras minúsculas.
- Log bruto
```
name: Etl
```
- Regra de transformação
```
e_set("str_lower", str_lower(v("name")))
```
- Resultado
```
name: Etl
str_lower: etl
```

str_upper

Converte todos os caracteres minúsculos de uma string para maiúsculos.

Sintaxe
```
str_upper(value)
```

Parâmetros

Parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser convertida.

Resposta

Retorna uma string convertida.
Exemplos

Converta o valor do campo name para letras maiúsculas.
- Log bruto
```
name: etl
```
- Regra de transformação
```
e_set("str_upper", str_upper(v("name")))
```
- Resultado
```
name: etl
str_upper: ETL
```

str_title

Coloca a primeira letra de cada palavra em maiúscula e as demais em minúscula.

Sintaxe
```
str_title(value)
```

Parâmetros

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser convertida.

Resposta

Retorna uma string convertida.
Exemplos

Coloque a primeira letra de cada palavra do valor do campo word em maiúscula.
- Log bruto
```
word: this is etl
```
- Regra de transformação
```
e_set("str_title", str_title(v("word")))
```
- Resultado
```
word: this is etl
str_title: This Is Etl
```

str_capitalize

A função str_capitalize coloca a primeira letra em maiúscula e as demais em minúscula.

Sintaxe
```
str_capitalize(value)
```

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser convertida.

Resposta

Retorna uma string convertida.
Exemplos

Coloque a primeira letra do valor do campo word em maiúscula e converta as demais letras para minúsculas.
- Log bruto
```
word: this Is MY EAL
```
- Regra de transformação
```
e_set("str_capitalize", str_capitalize(v("word")))
```
- Resultado
```
word: this Is MY EAL
str_capitalize: This is my eal
```

str_lstrip

A função str_lstrip exclui caracteres especificados do início de uma string.

Sintaxe
```
str_lstrip(value, chars)
```

Parâmetros

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string original a ser modificada.
chars	Arbitrário (convertido automaticamente para string)	Não	Conjunto de caracteres a excluir do início da string. Valor padrão: espaço.

Resposta

Retorna uma nova string.

Exemplos

Exemplo 1: Exclua os asteriscos (*) do início do valor do campo word.

Log bruto
```
word: ***this is string
```

Regra de transformação

e_set("str_lstrip", str_lstrip(v("word"), "*"))

Resultado

word: ***this is string
str_lstrip: this is string

Exemplo 2: Exclua os espaços do início do valor do campo word.

Log bruto
```
word:     this is string
```

Regra de transformação

e_set("str_lstrip", str_lstrip(v("word")))

Resultado

word:     this is string
str_lstrip: this is string

Exemplo 3: Exclua o conjunto de caracteres xy.

Log bruto
```
lstrip:xy123yx
```

Regra de transformação

e_set("str_lstrip", str_lstrip(v("lstrip"),"xy"))

Resultado
```
lstrip:xy123yx
str_lstrip:123yx
```

str_rstrip

Remove o caractere final especificado de uma string.

Sintaxe
```
str_rstrip(value, chars)
```

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string original a ser modificada.
chars	Arbitrário (convertido automaticamente para string)	Não	Conjunto de caracteres a excluir do fim da string. Valor padrão: espaço.

Resposta

Retorna uma nova string.

Exemplos

Exemplo 1: Exclua os asteriscos (*) do fim do valor do campo word.

Log bruto
```
word: this is string*****
```

Regra de transformação

e_set("str_rstrip", str_rstrip(v("word"), "*"))

Resultado

word: this is string*****
str_rstrip: this is string

Exemplo 2: Exclua o conjunto de caracteres xy.

Log bruto
```
word:xy123yx
```

Regra de transformação

e_set("str_rstrip", str_rstrip(v("word"), "xy"))

Resultado
```
word:xy123yx
str_rstrip:xy123
```

str_swapcase

Inverte a caixa dos caracteres de uma string.

Sintaxe
```
str_swapcase(value)
```

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser convertida.

Resposta

Retorna uma string convertida.

Exemplos

Log bruto
```
name: this is string
```

Regra de transformação

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

Resultado

name: this is string
str_swapcase: THIS IS STRING

str_translate

A função str_translate substitui caracteres com base em uma tabela de mapeamento.

Sintaxe

str_translate(value, replace_string, mapping_string)

Parâmetros

Nome do parâmetro	Tipos de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string original onde os caracteres serão substituídos.
replace_string	Arbitrário (convertido automaticamente para string)	Sim	O conjunto de caracteres a substituir.
mapping_string	Arbitrário (convertido automaticamente para string)	Sim	O conjunto de caracteres resultante após a substituição.

Resposta

Retorna uma nova string.

Exemplos

Log bruto
```
name: I love ETL!!!
```

Regra de transformação

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

Resultado

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

str_endswith

A função str_endswith verifica se uma string termina com um sufixo especificado.

Sintaxe
```
str_endswith(value, suffix, start, end)
```
Nota
Esta função suporta parâmetros variáveis básicos. Invocação de função.

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string original a verificar.
suffix	Arbitrário (convertido automaticamente para string)	Sim	O sufixo. O valor deste parâmetro pode ser uma string ou um elemento.
start	Número	Não	Posição inicial da verificação. O valor 0 indica o primeiro caractere. O valor -1 indica o último caractere.
end	Número	Não	Posição final da verificação. O valor 0 indica o primeiro caractere. O valor -1 indica o último caractere.

Resposta

Retorna True se a string terminar com o sufixo especificado. Caso contrário, retorna False.

Exemplos

Log bruto
```
name: this is endswith!!!
```

Regra de transformação

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

Resultado

name: this is endswith!!!
str_endswith: True

str_startswith

A função str_startswith verifica se uma string começa com um prefixo especificado.

Sintaxe
```
str_startswith(value, prefix, start, end)
```
Nota
Esta função suporta parâmetros variáveis básicos. Invocação de função.

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string original a verificar.
prefix	Arbitrário (convertido automaticamente para string)	Sim	O prefixo. O valor deste parâmetro pode ser uma string ou um elemento.
start	Número	Não	Posição inicial da verificação. O valor 0 indica o primeiro caractere. O valor -1 indica o último caractere.
end	Número	Não	Posição final da verificação. O valor 0 indica o primeiro caractere. O valor -1 indica o último caractere.

Resposta

Retorna True se a string começar com o prefixo especificado. Caso contrário, retorna False.

Exemplos

Log bruto
```
name: !! this is startwith
```

Regra de transformação

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

Resultado

name: !! this is startwith
str_startswith: True

str_find

Verifica se a string de origem contém a substring especificada.

Sintaxe
```
str_find(value, str, begin, end)
```
Nota
Esta função suporta parâmetros variáveis básicos. Invocação de função.

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	String original onde a substring será pesquisada.
str	Arbitrário (convertido automaticamente para string)	Sim	Substring a ser pesquisada.
begin	Número	Não	Posição inicial da pesquisa. O valor padrão 0 indica o primeiro caractere. O valor -1 indica o último caractere.
end	Número	Não	Posição final do índice. O valor padrão corresponde ao comprimento da string. O valor 0 indica o primeiro caractere. O valor -1 indica o último caractere.

Resposta

Retorna a posição da primeira ocorrência da substring especificada.

Exemplos

Log bruto
```
name: hello world
```

Regra de transformação

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

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

str_count

A função str_count conta as ocorrências de caracteres em uma string.

Sintaxe
```
str_count(value, sub, start, end)
```
Nota
Esta função suporta parâmetros variáveis básicos. Invocação de função.

Parâmetros

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	String de origem para contagem.
sub	Arbitrário (convertido automaticamente para string)	Sim	Caractere cujas ocorrências devem ser contadas.
start	Número	Não	Posição na string onde inicia a pesquisa pelo caractere especificado. Valores válidos: 0 (padrão): primeiro caractere -1: último caractere
end	Número	Não	Posição na string onde termina a pesquisa pelo caractere especificado. Valores válidos: 0: primeiro caractere -1 (padrão): último caractere

Resposta

Retorna o número de ocorrências do caractere especificado.

Exemplos

Log bruto
```
name: this is really a string
```

Regra de transformação

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

Resultado

name: this is really a string
str_count: 3

str_rfind

A função str_rfind retorna a posição da última ocorrência de uma substring.

Sintaxe
```
str_rfind(value, substr, beg, end)
```
Nota
Esta função suporta parâmetros variáveis básicos. Invocação de função.

Parâmetros

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	String de origem a ser pesquisada.
substr	Arbitrário (convertido automaticamente para string)	Sim	Caractere ou substring a ser pesquisado.
beg	Número	Não	Posição inicial da pesquisa. Valor padrão: 0.
end	Número	Não	Posição final da pesquisa. O valor padrão é o comprimento da string.

Resposta

Retorna a posição da última ocorrência do caractere ou string especificado.

Exemplos

Log bruto
```
name: this is really a string
```

Regra de transformação

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

Resultado

name: this is really a string
str_rfind: 20

str_split

Divide uma string em substrings com base em um separador especificado.

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

Parâmetros

Nome do parâmetro	Tipos de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	String original a ser dividida.
sep	Número	Não	Delimitador. O valor None indica um espaço.
maxsplit	Número	Não	Número máximo de substrings resultantes da divisão. O valor -1 indica que não há limite.

Resposta

Retorna as strings processadas.

Exemplos

Divida o valor do campo content usando o delimitador de espaço.

Log bruto
```
content: hello world
```

Regra de transformação

e_set("str_split", str_split(v("content"), " "))

Resultado

content: hello world
str_split: ["hello", "world"]

str_splitlines

Permite dividir uma string por quebras de linha.

Sintaxe
```
str_splitlines(value, keepends)
```

Parâmetros

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	String original a ser dividida.
keepends	Booleano	Não	Define se as quebras de linha devem ser mantidas no resultado. As quebras incluem `\r`, `\r\n` e `\n`. Valor padrão: False, que remove as quebras de linha. O valor True mantém as quebras de linha.

Resposta

Retorna a lista processada.

Exemplos

Exemplo 1

Log bruto
```
content: ab c\n\nde fg\rkl\r\n
```

Regra de transformação

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']

Exemplo 2

Log bruto
```
content: ab c\n\nde fg\rkl\r\n
```

Regra de transformação

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

A função str_partition divide uma string em três partes, da esquerda para a direita, usando um delimitador especificado.

Sintaxe
```
str_partition(value, substr)
```

Parâmetros

Parâmetro	Tipos de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	String a ser dividida.
substr	Arbitrário (convertido automaticamente para string)	Não	Delimitador utilizado na divisão.

Resposta

Retorna a lista resultante da divisão.
Exemplos

Divida o valor do campo website em três partes, da esquerda para a direita, usando o delimitador ..
- Log bruto
```
website: www.aliyun.com
```
- Regra de transformação
```
e_set("str_partition", str_partition(v("website"), "."))
```
- Resultado
```
website: www.aliyun.com
str_partition:  ["www", ".", "aliyun.com"]
```

str_rpartition

A função str_rpartition divide uma string em três partes, da direita para a esquerda, usando um delimitador especificado.

Sintaxe
```
str_rpartition(value, substr)
```

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	String original a ser dividida.
substr	Arbitrário (convertido automaticamente para string)	Não	Delimitador utilizado na divisão.

Resposta

Retorna a lista processada.

Exemplos

Divida o valor do campo website em três partes, da direita para a esquerda, usando o delimitador ..

Log bruto
```
website: www.aliyun.com
```

Regra de transformação

e_set("str_partition", str_rpartition(v("website"), "."))

Resultado

  website: www.aliyun.com
  str_partition: ["www.aliyun", ".", "com"]

str_center

Preenche uma string até atingir um comprimento especificado, utilizando um caractere definido.

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

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	String original a ser modificada.
width	Número	Sim	Comprimento final da string após o preenchimento.
fillchar	Arbitrário (convertido automaticamente para string)	Não	Caractere usado no preenchimento. Valor padrão: espaço.

Resposta

Retorna uma nova string.

Nota
Se o comprimento da nova string após o preenchimento for menor que o da string original, a função retorna a string original sem alterações.

Exemplos

Exemplo 1: Preencher uma string usando asteriscos (*).

Log bruto
```
center: this is center
```

Regra de transformação

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

Resultado

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

Exemplo 2: Preencher uma string usando espaços.

Log bruto
```
center: this is center
```

Regra de transformação

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

Resultado

center: this is center
str_center:              this is center

str_zfill

A função str_zfill preenche uma string à esquerda com zeros até atingir o comprimento especificado.

Sintaxe
```
str_zfill(value, width)
```

Parâmetros

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	String original a ser modificada.
width	Número	Sim	Comprimento final da string após o preenchimento.

Resposta

Retorna uma nova string.

Exemplos

Log bruto
```
center: this is zfill
```

Regra de transformação

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

Resultado

center:this is zfill
str_zfill:000000000000000000000000000this is zfill

str_expandtabs

Substitui \t em uma string por espaços.

Sintaxe
```
str_expandtabs(value, tabsize)
```

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	String original a ser modificada.
tabsize	Número	Sim	Quantidade de espaços após a conversão.

Resposta

Retorna uma nova string.

Exemplos

Exemplo 1: Converter \t no valor do campo logstash para espaços.

Log bruto
```
logstash: this is\tstring
```

Regra de transformação

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

Resultado

logstash: this is\tstring
str_expandtabs: this is string

Exemplo 2: Converter \t no valor do campo center para espaços.

Log bruto
```
{"center": "this is\tstring"}
```

Regra de transformação

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

Resultado

center: this is\tstring
str_expandtabs: this is         string

str_ljust

A função str_ljust preenche uma string à direita até atingir um comprimento especificado, usando um caractere definido.

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

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	String original a ser modificada.
width	Número	Sim	Comprimento final da string após o preenchimento.
fillchar	Arbitrário (convertido automaticamente para string)	Não	Caractere usado no preenchimento. Valor padrão: espaço.

Resposta

Retorna uma nova string.

Nota
Se o comprimento da nova string após o preenchimento for menor que o da string original, a função retorna a string original sem alterações.

Exemplos

Exemplo 1

Log bruto
```
content: this is ljust
```

Regra de transformação

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

Resultado

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

Exemplo 2

Log bruto
```
center: this is ljust
```

Regra de transformação

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

Resultado

center: this is ljust
str_ljust: this is ljust

Exemplo 3: Se a largura for menor ou igual ao comprimento da string, a função retorna a string original.
- Log bruto
```
center: this is ljust
```
- Regra de transformação
```
e_set("str_ljust", str_ljust(v("center"),10,  "*"))
```
- Resultado
```
center: this is ljust
str_ljust: this is ljust
```

str_rjust

A função str_rjust preenche uma string à esquerda até atingir um comprimento especificado, usando um caractere definido.

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

Parâmetros

Parâmetro	Tipos de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	String original a ser modificada.
width	Número	Sim	Comprimento final da string após o preenchimento.
fillchar	Arbitrário (convertido automaticamente para string)	Não	Caractere usado no preenchimento. Valor padrão: espaço.

Resposta

Retorna uma nova string.

Nota
Se o comprimento da nova string após o preenchimento for menor que o da string original, a função retorna a string original sem alterações.

Exemplos

Log bruto
```
center: this is rjust
```

Regra de transformação

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

Resultado

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

str_zip

Divide dois valores de string ou expressões e combina os resultados em uma única string.

Sintaxe

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

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value1	Arbitrário (convertido automaticamente para string)	Sim	Valor a ser combinado.
value2	Arbitrário (convertido automaticamente para string)	Sim	Valor a ser combinado.
combine_sep	Arbitrário (convertido automaticamente para string)	Não	Identificador usado para combinar os elementos. Valor padrão: `#`.
sep	Arbitrário (convertido automaticamente para string)	Não	Delimitador usado entre os elementos após a combinação. Deve ser um único caractere. Valor padrão: `,`.
quote	Arbitrário (convertido automaticamente para string)	Não	Caractere usado para envolver os elementos após a combinação. Este parâmetro é necessário se os valores contiverem delimitadores. Valor padrão: `"`.
lparse	Arbitrário (convertido automaticamente para string)	Não	Delimitador e aspas usados entre os elementos de `value1`. Delimitador padrão: `,`. Aspas padrão: `"`. Formato: `lparse=(',', '"')`. Nota As aspas têm prioridade maior que o delimitador.
rparse	Arbitrário (convertido automaticamente para string)	Não	Delimitador e aspas usados entre os elementos de `value2`. Delimitador padrão: `,`. Aspas padrão: `"`. Formato: `rparse=(',', '"')`. Nota As aspas têm prioridade maior que o delimitador.

Resposta

Retorna uma string combinada.

Exemplos

Exemplo 1

Log bruto
```
website: wwww.aliyun.com
escape_name: o
```

Regra de transformação

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

Exemplo 2

Log bruto
```
website: wwww.aliyun.com
escape_name: o
```

Regra de transformação

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

Resultado

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

Exemplo 3: Uso do parâmetro sep.

Log bruto
```
f1: a,b,c
f2: x,y,z
```

Regra de transformação

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

Exemplo 4: Uso do parâmetro quote.

Log bruto
```
f1: "a,a", b, "c,c"
f2: x, "y,y", z
```

Regra de transformação

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|

Exemplo 5: Uso de valores de campo com comprimentos diferentes.
- Log bruto
```
f1: a,b
f2: x,y,z
```
- Regra de transformação
```
e_set("combine", str_zip(v("f1"), v("f2")))
```
- Resultado
```
f1: a,b
f2: x,y,z
combine: a#x,b#y
```

Exemplo 6: Uso dos parâmetros lparse e rparse.

Log bruto
```
f1: a#b#c
f2: x|y|z
```

Regra de transformação

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

Exemplo 7: Uso dos parâmetros lparse e rparse.

Log bruto
```
f1: |a,a|, b, |c,c|
f2: x, #y,y#, z
```

Regra de transformação

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

Verifica se uma string é alfanumérica.

Sintaxe
```
str_isalnum(value)
```

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser verificada.

Resposta

Retorna o valor True ou False.

Exemplos

Log bruto
```
content: 13
```

Regra de transformação

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

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

str_isalpha

Verifica se uma string contém apenas letras.

Sintaxe
```
str_isalpha(value)
```

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser verificada.

Resposta

Retorna o valor True ou False.

Exemplos

Log bruto
```
content: 13
```

Regra de transformação

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

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

str_isascii

Determina se a string é ASCII.

Sintaxe
```
str_isascii(value)
```

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser verificada.

Resposta

Retorna o valor True ou False.

Exemplos

Log bruto
```
content: asw123
```

Regra de transformação

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

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

str_isdecimal

Verifica se uma string contém apenas caracteres decimais.

Sintaxe
```
str_isdecimal(value)
```

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser verificada.

Resposta

Retorna o valor True ou False.

Exemplos

Exemplo 1

Log bruto
```
welcome: Hello
```

Regra de transformação

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

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

Exemplo 2

Log bruto
```
num: 123
```

Regra de transformação

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

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

str_isdigit

Verifica se uma string contém apenas dígitos.

Sintaxe
```
str_isdigit(value)
```

Parâmetros

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser verificada.

Resposta

Retorna o valor True ou False.

Exemplos

Log bruto
```
content: 13
```

Regra de transformação

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

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

str_isidentifier

Determina se uma string é um identificador Python válido.

Sintaxe
```
str_isidentifier(value)
```

Parâmetros

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser verificada.

Resposta

Retorna o valor True ou False.

Exemplos

Log bruto
```
class: class
```

Regra de transformação

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

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

str_islower

Verifica se uma string contém apenas letras minúsculas.

Sintaxe
```
str_islower(value)
```

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser verificada.

Resposta

Retorna o valor True ou False.

Exemplos

Log bruto
```
lower: asds
```

Regra de transformação

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

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

str_isnumeric

Verifica se uma string contém apenas dígitos numéricos.

Sintaxe
```
str_isnumeric(value)
```

Parâmetros

Parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser verificada.

Resposta

Retorna o valor True ou False.

Exemplos

Log bruto
```
num: 123
```

Regra de transformação

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

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

str_isprintable

A função str_isprintable verifica se todos os caracteres de uma string são imprimíveis.

Sintaxe
```
str_isprintable(value)
```

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser verificada.

Resposta

Retorna o valor True ou False.

Exemplos

Log bruto
```
content: vs;,.as
```

Regra de transformação

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

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

str_isspace

Determina se uma string consiste apenas em caracteres de espaço.

Sintaxe
```
str_isspace(value)
```

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser verificada.

Resposta

Retorna o valor True ou False.

Exemplos

Log bruto
```
space:  as afsd
```

Regra de transformação

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

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

str_istitle

Verifica se a primeira letra de cada palavra em uma string é maiúscula e as demais são minúsculas.

Sintaxe
```
str_istitle(value)
```

Parâmetros

Parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser verificada.

Resposta

Retorna o valor True ou False.

Exemplos

Log bruto
```
title: Alex Is A Boy
```

Regra de transformação

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

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

str_isupper

Verifica se todas as letras da string são maiúsculas.

Sintaxe
```
str_isupper(value)
```

Parâmetros

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
value	Arbitrário (convertido automaticamente para string)	Sim	A string a ser verificada.

Resposta

Retorna o valor True ou False.

Exemplos

Log bruto
```
content: ASSD
```

Regra de transformação

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

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

str_uuid

Gera um UUID aleatório.

Sintaxe
```
str_uuid(lower=True)
```

Parâmetros

Nome do parâmetro	Tipo	Obrigatório	Descrição
lower	Booleano	Não	Especifica se as letras no UUID de saída devem estar em minúsculas. Valor padrão: True, indicando que as letras estarão em minúsculas.

Resposta

Um UUID é retornado.

Exemplos

Exemplo 1

Log bruto
```
content: I am Iron man
```
Regra de transformação
```
e_set("UUID", str_uuid())
```

Resultado

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

Exemplo 2

Log bruto
```
content: I am Iron man
```
Regra de transformação
```
e_set("UUID", str_uuid(lower=False))
```

Resultado

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