Atualizado
Isto foi útil?
Atualizado
Isto foi útil?
As funções de string são usadas para manipular dados de string. Estas são as funções de string que você pode usar com a linguagem Double Braces da Digibee:
Coloca o primeiro caractere de uma string em caixa alta. Outros caracteres não são afetados.
value: a string cuja primeira letra deve ser maiúscula.
Retorna: uma string que é uma versão de value com o primeiro caractere em caixa alta.
O resultado esperado é:
Concatena qualquer número de strings em uma única string.
values: qualquer número de strings a serem concatenadas.
Retorna: a string concatenada.
O resultado esperado é:
Verifica se uma substring está contida em uma determinada string.
main_string: a string principal a ser pesquisada.
sub_string: a substring a ser procurada.
Retorna: um valor booleano indicando se a substring foi encontrada ou não. Retorna true se a substring for encontrada na string principal e false, caso contrário.
O resultado esperado é:
Retorna um valor padrão quando uma referência é feita a um valor nulo ou inexistente.
value: o valor a ser verificado quanto à nulidade ou inexistência.
defaultValue: o valor padrão a ser retornado se value for nulo ou inexistente.
Retorna: value, se value não for nulo ou inexistente, ou defaultValue, se for.
Suponha que você esteja usando esta função no parâmetro JSON de um componente JSON Generator que recebe o seguinte payload:
Você pode usar a função DEFAULT para substituir o valor nulo por uma string "não disponível".
O resultado esperado é:
Leia este artigo para saber mais sobre como referenciar dados com Double Braces.
Codifique uma string usando sequências de escape.
value: a string a ser codificada.
escapeType: o tipo de sequência de escape a ser utilizada. As opções válidas são "JSON", "XML", "CSV" e "HTML". Caso não especificado, assume valor padrão "JSON".
Retorna: uma nova string na qual certos caracteres foram substituídos por sequências de escape.
O resultado esperado é:
Retorna o índice da primeira ocorrência de uma substring dentro de uma string determinada. Essa pesquisa diferencia maiúsculas de minúsculas e o índice começa em 0.
main_string: a string principal a ser pesquisada.
sub_string: a substring a ser procurada.
fromIndex: o índice a partir do qual a pesquisa deve começar. Caso não especificado, assume valor padrão 0.
Retorna: um integer indicando o índice da primeira ocorrência da substring na string principal. Se a substring não for encontrada, a função retorna -1.
O resultado esperado é:
O resultado esperado é:
Concatena uma lista de strings em uma única string com um caractere separador especificado entre cada string.
separator: uma string representando o caractere separador a ser usado entre cada string.
values: qualquer número de strings a serem concatenados.
Retorna: a string concatenada com o caractere separador especificado entre cada string no input.
O resultado esperado é:
O resultado esperado é:
Retorna o índice da última ocorrência de uma substring dentro de uma determinada string. Essa pesquisa diferencia maiúsculas de minúsculas e o índice começa em 0.
main_string: a string principal a ser pesquisada.
sub_string: a substring a ser procurada.
fromIndex: o índice a partir do qual a pesquisa deve começar. O padrão é 0.
Retorna: um integer indicando o índice da última ocorrência da substring na string principal. Se a substring não for encontrada, a função retornará -1.
O resultado esperado é:
Como a substring "a" não está contida na string "Hello, world!", o resultado esperado é:
Preenche o lado esquerdo de uma determinada string com um caractere especificado até um tamanho específico.
value: a string de entrada a ser preenchida.
length: o comprimento da string desejada.
character: o caractere que será usado para preencher o lado esquerdo da string de entrada. Por padrão, um espaço em branco.
Retorna: uma string preenchida do comprimento desejado com o caractere especificado preenchendo o lado esquerdo da string de entrada. Se o comprimento da string de entrada já for maior ou igual ao especificado, a string original será retornada.
O resultado esperado é:
Como "hello" já possui 5 caracteres, o resultado esperado é:
Converte todos os caracteres em minúsculos.
value: a string de entrada a ser convertida em letras minúsculas.
Retorna: a string que é o equivalente em minúsculas da string de entrada.
O resultado esperado é:
Verifica se uma string corresponde a uma expressão regular.
value: uma string que deve ser comparada com a expressão regular fornecida.
pattern: um padrão de expressão regular que deve ser usado para corresponder à string de entrada.
Retorna: true, se a string de entrada corresponder à expressão regular, false, caso contrário.
O resultado esperado é:
Transforma quaisquer caracteres especiais em caracteres não especiais.
value: a string a ser normalizada.
Retorna: a string normalizada com caracteres especiais substituídos por suas contrapartes não especiais.
O resultado esperado é:
Gera strings aleatórias dados um conjunto de caracteres e o comprimento da string.
charset: o conjunto de caracteres a ser usado. As opções são: "ALPHANUMERIC", "ALPHABETIC" , "ASCII", e "NUMERIC".
length: o comprimento da string de saída.
O output varia porque é aleatório. Um output possível é:
Substitui todas as ocorrências de uma substring em uma string com base em uma determinada expressão regular.
value: a string a ser pesquisada e alterada.
pattern: um padrão de expressão regular que especifica a substring a ser pesquisada.
replacement: uma string que substituirá todas as ocorrências do padrão correspondente na string de entrada.
O resultado esperado é:
Preenche o lado direito de uma determinada string com um caractere especificado até um comprimento específico.
value: a string de entrada a ser preenchida.
length: o comprimento da string desejada.
character: o caractere que será usado para preencher o lado direito da string de entrada. Por padrão, um espaço em branco.
Retorna: uma string preenchida do comprimento desejado com o caractere especificado preenchendo o lado direito da string de entrada. Se o comprimento da string de entrada já for igual ou maior que o especificado, a string original será retornada.
O resultado esperado é:
Como "hello" já possui 5 caracteres, o resultado esperado é:
Divide uma string em um array de strings com base em um padrão de expressão regular especificado.
value: a string a ser dividida.
pattern: um padrão de expressão regular que especifica o ponto de divisão. A string será dividida em todas as ocorrências do padrão.
Retorna: um array de strings resultante da operação de divisão.
O resultado esperado é:
Retorna um array de todas as expressões correspondentes em uma string que atendem a um determinado padrão de expressão regular.
value: uma string para procurar correspondências.
pattern: um padrão de expressão regular para corresponder à string.
patternFlag: o comportamento do mecanismo de expressão regular. Isso pode ser usado para modificar o comportamento de correspondência da expressão regular. Se não for especificado, o mecanismo de expressão regular usará seu comportamento padrão. As opções são:
CANON_EQ: ativa a correspondência de equivalência canônica de caracteres Unicode. Quando esse pattern flag é ativado, os caracteres que parecem idênticos são correspondidos, mesmo que tenham codepoints diferentes no Unicode.
CASE_INSENSITIVE: desativa a diferenciação de maiúsculas e minúsculas.
COMMENTS: permite comentários no padrão de expressão regular. Você pode adicionar comentários após uma hashtag #.
DOTALL: ativa o modo "dotall", que permite que um ponto. corresponda ao caractere de nova linha\n.
LITERAL: quando este sinalizador é especificado, a string de entrada que especifica o padrão é tratada como uma sequência de caracteres literais. Metacaracteres ou sequências de escape na sequência de entrada não terão nenhuma interpretação especial.
MULTILINE: ativa a correspondência em várias linhas.
UNICODE_CASE: permite correspondência sem distinção entre maiúsculas e minúsculas de caracteres Unicode, levando em consideração as case folding rules do Unicode.
UNICODE_CHARACTER_CLASS: permite classes de caracteres Unicode no padrão de expressão regular.
UNIX_LINES: altera o comportamento dos metacaracteres ^ e $ para coincidir com o início e o fim de uma linha, respectivamente, em vez do início e do fim da string de entrada.
Retorna: um array de todas as expressões correspondentes na string que satisfazem o padrão inserido.
O resultado esperado é:
Extrai uma substring de uma determinada string.
value: a string original da qual a substring deve ser extraída.
start: o índice inicial da substring. O índice começa em 0.
end: o índice final da substring. Se não for fornecido, a extração terminará no último caractere da string original.
throwIndexOutOfBoundError: se true, um erro será gerado se os índices fornecidos estiverem fora do intervalo. Caso contrário, a string original será retornada. Assume valor true por padrão.
Retorna: a substring extraída da string original.
O resultado esperado é:
Converte um objeto em sua representação de string.
object: o objeto a ser convertido em uma string. Pode ser de qualquer tipo.
O resultado esperado é:
Remove espaços em branco no início e no final de uma string.
value: a string a ser aparada.
Retorna: uma string que é uma versão aparada de value.
O resultado esperado é:
Decodifica uma string que possui sequências de escape.
value: a string a ser decodificada.
escapeType: o tipo de sequência de escape a ser utilizada. As opções válidas são "JSON", "XML", "CSV" e "HTML". O padrão é "JSON".
Retorna: uma nova string na qual certos caracteres foram substituídos por sequências de escape.
O resultado esperado é:
Converte todos os caracteres em maiúsculas.
value: a string de entrada cujos caracteres devem ser convertidos em letras maiúsculas.
Retorna: o equivalente maiúsculo da string de entrada.
O resultado esperado é:
Aprenda sobre as funções de string da Digibee Integration Platform e como utilizá-las.