Funções de strings string-functions

concat(<string>,<string>)

concat(<listString>)

Retorna uma string.

concat("Hello","World")

Retorna “HelloWorld”.

concat(["Hello"," ","World"])

Retorna “Olá, Mundo”.

• sequência de caracteres

contain(<string>,<string>)

Retorna um valor booleano.

contain("rowing is great", "great")

Retorna verdadeiro.

containIgnoreCase(<string>,<string>)

Retorna um valor booleano.

containIgnoreCase("rowing is great", "GREAT")

Retorna verdadeiro.

endWith(<string>,<string>)

Retorna um valor booleano.

endWith("Hello World", "World")

Retorna verdadeiro.

endWith("Hello World", "Hello")

Retorna falso.

endWithIgnoreCase(<string>,<string>)

Retorna um valor booleano.

endWithIgnoreCase("rowing is great", "AT")

Retorna verdadeiro.

• sequência de caracteres

equalIgnoreCase(<string>,<string>)

Retorna um valor booleano.

equalIgnoreCase("rowing is great", "rowing is GREAT")

Retorna verdadeiro.

indexOf(<string>,<string>)

Retorna um inteiro.

indexOf("Hello", "l")

Retorna 2.

Explicação:

Em “Olá”, a primeira ocorrência de “l” está na posição 2.

• sequência de caracteres

isEmpty(<string>)

Retorna um valor booleano.

isEmpty("")

Retorna verdadeiro.

isEmpty("Hello World")

Retorna falso.

isEmpty(<null>)

Retorna falso.

• sequência de caracteres

isNotEmpty(<string>)

Retorna um valor booleano.

isNotEmpty("")

Retorna falso.

isNotEmpty("hello")

Retorna verdadeiro.

lastIndexOf(<string>,<string>)

Retorna um inteiro.

lastIndexOf("Hello", "l")

Retorna 3.

Explicação:

Em “Olá”, a última ocorrência de “l” está na posição 3.

• sequência de caracteres

length(<string>)

Retorna um inteiro.

length("Hello World")

Retorna 11.

• sequência de caracteres

lower(<string>)

Retorna uma string.

lower("A")

Retorna “a”.

matchRegExp(<string>,<string>)

Retorna um valor booleano.

matchRegExp("12345", "\\d+")

Retorna verdadeiro.

• sequência de caracteres

notEqualIgnoreCase(<string>,<string>)

Retorna um valor booleano.

replace(<base>,<target>,<replacement>)

Retorna uma string.

replace("Hello World", "l", "x")

Retorna “Hexlo World”.

Exemplo com RegExp:

Como o parâmetro de destino é um RegExp, dependendo da cadeia de caracteres que você deseja substituir, talvez seja necessário usar escape em alguns caracteres. Exemplo:

• cadeia de caracteres a ser avaliada: |OFFER_A|OFFER_B
• fornecido por um atributo de perfil #{ExperiencePlatform.myFieldGroup.profile.myOffers}
• Cadeia de caracteres a ser substituída: |OFFER_A
• Cadeia de caracteres substituída por: ''
• É necessário adicionar \\ antes do caractere |.

A expressão é:

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|OFFER_A', '')

A cadeia de caracteres retornada é: |OFFER_B

Também é possível criar a cadeia de caracteres a ser substituída a partir de um determinado atributo:

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|' + #{ExperiencePlatform.myFieldGroup.profile.myOfferCode}, '')

replaceAll(<baseString>,<sourceString>,<replacementString>)

Retorna uma string.

replaceAll("Hello World", "l", "x")

Retorna “Hexxo Worxd”.

Como o parâmetro de destino é um RegExp, dependendo da cadeia de caracteres que você deseja substituir, talvez seja necessário usar escape em alguns caracteres. Consulte o exemplo na função replace.

split(<input string>, <separator string>)

Retorna uma listString.

split("A_B_C", "_")

Retorna ["A","B","C"]

Exemplo com um campo de evento “event.appVersion” com valor: “20.45.2.3434”

split(@event{event.appVersion}, "\\.")

Retorna ["20", "45", "2", "3434"]

startWith(<string>,<string>)

Retornar um booleano.

startWith("Hello World", "Hello")

Retorna verdadeiro.

startWith("Hello World", "World")

Retorna falso.

startWithIgnoreCase(<string>,<string>)

Retornar um booleano.

startWithIgnoreCase("rowing is great", "RO")

Retorna verdadeiro.

substr(<string>,<beginIndex>)

substr(<string>,<beginIndex>,<endIndex>)

Retorna uma string.

substr("Hello World",6)

Retorna “Mundo”.

substr("Hello World", 0, 5)

Retorna “Olá”.

trim(<string>)

Retorna uma string.

trim(" Hello ")

Retorna “Olá”.

upper(<string>)

Retorna uma string.

upper("b")

Retorna “B”.

uuid()

Retorna uma string.

uuid()

Retorna “79e70b7f-8a85-400b-97a1-9f9826121553”.

Esta seção contém conhecimento estruturado destinado a oferecer suporte à interpretação, recuperação e resposta a perguntas relacionadas a este tópico.

Para uma compreensão completa, essas informações devem ser combinadas com a documentação desta página. Nenhuma das origens deve ser independente; a página descreve o recurso, enquanto esta seção fornece um contexto adicional que ajuda a desfazer a ambiguidade da terminologia, intenção, aplicabilidade e restrições.

• TL;DR: esta página documenta todas as funções de cadeia de caracteres disponíveis nas expressões de jornada do AJO, abrangendo pesquisa de texto, comparação, transformação, extração, validação, substituição, divisão e geração de identificador exclusivo.

Intenções:

• Concatenar duas ou mais cadeias de caracteres usando concat
• Pesquisar uma subcadeia de caracteres em uma cadeia de caracteres (diferencia maiúsculas de minúsculas ou não diferencia maiúsculas de minúsculas) usando contain ou containIgnoreCase
• Comparar duas cadeias de caracteres ao ignorar maiúsculas e minúsculas usando equalIgnoreCase ou notEqualIgnoreCase
• Verifique se uma cadeia de caracteres começa ou termina com um prefixo ou sufixo específico usando startWith, endWith e suas variantes que não diferenciam maiúsculas de minúsculas
• Extrair uma subcadeia de caracteres por posições de índice usando substr
• Substituir a primeira ou todas as ocorrências de um padrão em uma cadeia de caracteres usando replace ou replaceAll
• Dividir uma cadeia de caracteres em uma lista de tokens por um separador usando split
• Gerar uma UUID aleatória para as necessidades de identificador exclusivo usando uuid
• Verifique se a cadeia de caracteres está vazia ou não usando isEmpty ou isNotEmpty

Glossário:

• RegExp: um padrão de expressão regular usado como parâmetro de destino em replace, replaceAll e matchRegExp — caracteres especiais devem ter escape com \\
• UUID: Identificador Exclusivo Universal — um identificador de cadeia de caracteres gerado aleatoriamente e retornado por uuid()
• substr: extrai uma parte de uma cadeia de caracteres especificando um índice inicial e um índice final opcional (baseado em zero)

Medidas de Proteção:

• O parâmetro target em replace e replaceAll é tratado como um RegExp; caracteres especiais (por exemplo, |, .) devem ser evitados com \\
• replace substitui somente a primeira ocorrência correspondente; use replaceAll para substituir cada ocorrência
• isEmpty retorna falso para valores nulos (não verdadeiro); nulo não é considerado uma cadeia de caracteres vazia
• indexOf e lastIndexOf retornam -1 quando nenhuma correspondência for encontrada
• As posições do índice de string são baseadas em zero (o primeiro caractere está na posição 0)

Terminologia:

• Nome canônico: Funções de string — Acrônimo: none — variantes: funções de texto, funções de manipulação de string
• Sinônimos: “contain” = “substring check”; “split” = “tokenize string”; “trim” = “strip whitespace”
• Não confunda: “replace” (apenas a primeira ocorrência) ≠ “replaceAll” (todas as ocorrências)
• Não confundir: “indexOf” (primeira posição de ocorrência) ≠ “lastIndexOf” (última posição de ocorrência)
• Não confunda: “isEmpty” (true somente para cadeia de caracteres de comprimento zero) ≠ verificação nula (isEmpty retorna false para nulo)
• Não confunda: “equalIgnoreCase” (retorna true quando ignora maiúsculas e minúsculas de igual ignorância) ≠ “notEqualIgnoreCase” (retorna true quando ignora maiúsculas e minúsculas de diferente ignorância)

Perguntas frequentes:

• P: Como verificar se uma cadeia de caracteres contém uma subsequência, independentemente de caracteres maiúsculos ou minúsculos? — Use containIgnoreCase("myString", "searchTerm"), que retornará true se o termo de pesquisa for encontrado em qualquer caso.
• P: Qual é a diferença entre replace e replaceAll? — replace substitui somente a primeira ocorrência correspondente; replaceAll substitui cada ocorrência na cadeia de caracteres.
• P: Por que preciso usar o caractere | como escape em replace? — O parâmetro de destino é tratado como uma expressão regular; | é um caractere RegExp especial e deve ter escape como \\| para ser tratado como um pipe literal.
• P: isEmpty retorna verdadeiro para nulo? — Não, isEmpty retorna falso para nulo; ele só retorna verdadeiro para uma cadeia de caracteres de comprimento zero "".
• P: Como extrair o número da versão principal de uma cadeia de caracteres de versão como “20.45.2.3434”? — Use getListItem(split(@event{event.appVersion}, "\\."), 0) para dividir por ponto e recuperar o primeiro elemento.
• P: Como faço para gerar um identificador exclusivo em uma expressão de jornada? — Use uuid(), que retorna uma cadeia de caracteres UUID gerada aleatoriamente sem parâmetros necessários.