Funções de strings string

Saiba como usar funções de string no editor de personalização.

Camel Case camelCase

A função camelCase coloca a primeira letra de cada palavra de uma cadeia de caracteres em maiúscula.

Sintaxe

{%= camelCase(string)%}

Exemplo

A função a seguir colocará a primeira letra da palavra em maiúscula no endereço do perfil.

{%= camelCase(profile.homeAddress.street) %}

Código de caractere em char-code-at

A função charCodeAt retorna o valor ASCII de um caractere, como a função charCodeAt no JavaScript. Ele pega uma string e um inteiro (definindo a posição do caractere) como argumentos de entrada e retorna seu valor ASCII correspondente.

Sintaxe

{%= charCodeAt(string,int) %}: int

Exemplo

A função a seguir retorna o valor ASCII de ou seja, 111.

{%= charCodeAt("some", 1)%}

Concat concate

A função concat combina duas cadeias de caracteres em uma.

Sintaxe

{%= concat(string,string) %}

Exemplo

A função a seguir combinará a cidade e o país do perfil em uma única sequência.

{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}

Contains contains

A função contains é usada para determinar se uma cadeia de caracteres contém uma subsequência especificada.

Sintaxe

{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}

Exemplos

Não contém doesNotContain

A função doesNotContain é usada para determinar se uma cadeia de caracteres não contém uma subsequência especificada.

Sintaxe

{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}

Exemplo

A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o endereço de email da pessoa não contém a cadeia de caracteres "2010@gm".

{%= doesNotContain(profile.person.emailAddress,"2010@gm")%}

Não termina com doesNotEndWith

A função doesNotEndWith é usada para determinar se uma cadeia de caracteres não termina com uma subsequência especificada.

Sintaxe

{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

Exemplo

A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o endereço de email da pessoa não termina com ".com".

doesNotEndWith(person.emailAddress,".com")

Não inicia com doesNotStartWith

A função doesNotStartWith é usada para determinar se uma cadeia de caracteres não inicia com uma subcadeia especificada.

Sintaxe

{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

Exemplo

A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa não começa com "Joe".

{%= doesNotStartWith(person.name,"Joe")%}

Codificação 64 encode64

A função encode64 é usada para codificar uma sequência de caracteres para preservar as Informações Pessoais (PI), se elas forem incluídas, por exemplo, em uma URL.

Sintaxe

{%= encode64(string) %}

Termina com endsWith

A função endsWith é usada para determinar se uma sequência de caracteres termina com uma subsequência especificada.

Sintaxe

{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

Exemplo

A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o endereço de email da pessoa termina com ".com".

{%= endsWith(person.emailAddress,".com") %}

Igual a equals

A função equals é usada para determinar se uma cadeia de caracteres é igual à cadeia especificada, com distinção entre maiúsculas e minúsculas.

Sintaxe

{%= equals(STRING_1, STRING_2) %}

Exemplo

A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa é "John".

{%=equals(profile.person.name,"John") %}

Ignorar maiúsculas e minúsculas é igual a equalsIgnoreCase

A função equalsIgnoreCase é usada para determinar se uma cadeia de caracteres é igual à cadeia especificada, sem diferenciar maiúsculas de minúsculas.

Sintaxe

{%= equalsIgnoreCase(STRING_1, STRING_2) %}

Exemplo

A consulta a seguir determina, sem distinção entre maiúsculas e minúsculas, se o nome da pessoa é "John".

{%= equalsIgnoreCase(profile.person.name,"John") %}

Extrair domínio de email extractEmailDomain

A função extractEmailDomain é usada para extrair o domínio de um endereço de email.

Sintaxe

{%= extractEmailDomain(string) %}

Exemplo

A consulta a seguir extrai o domínio de email do endereço de email pessoal.

{%= extractEmailDomain(profile.personalEmail.address) %}

Formatar moeda format-currency

A função formatCurrency é usada para converter qualquer número em sua representação de moeda sensível ao idioma correspondente, dependendo da localidade transmitida como uma cadeia de caracteres no segundo argumento.

Sintaxe

{%= formatCurrency(number/double,string) %}: string

Exemplo

Esta consulta retorna £ 56,00

{%= formatCurrency(56L,"en_GB") %}

Obter host de URL get-url-host

A função getUrlHost é usada para recuperar o nome de host de uma URL.

Sintaxe

{%= getUrlHost(string) %}: string

Exemplo

{%= getUrlHost("https://www.myurl.com/contact") %}

Retorna "www.myurl.com"

Obter caminho de URL get-url-path

A função getUrlPath é usada para recuperar o caminho após o nome de domínio de uma URL.

Sintaxe

{%= getUrlPath(string) %}: string

Exemplo

{%= getUrlPath("https://www.myurl.com/contact.html") %}

Retorna "/contact.html"

Obter protocolo de URL get-url-protocol

A função getUrlProtocol é usada para recuperar o protocolo de uma URL.

Sintaxe

{%= getUrlProtocol(string) %}: string

Exemplo

{%= getUrlProtocol("https://www.myurl.com/contact.html") %}

Retorna "http"

Índice de index-of

A função indexOf é usada para retornar a posição (no primeiro argumento) da primeira ocorrência do segundo parâmetro. Retorna -1 se não houver correspondência.

Sintaxe

{%= indexOf(STRING_1, STRING_2) %}: integer

Exemplo

{%= indexOf("hello world","world" ) %}

Retorna 6.

Está vazio isEmpty

A função isEmpty é usada para determinar se uma cadeia de caracteres está vazia.

Sintaxe

{%= isEmpty(string) %}

Exemplo

A função a seguir retornará 'true' se o número de telefone celular do perfil estiver vazio. Caso contrário, retornará 'false'.

{%= isEmpty(profile.mobilePhone.number) %}

Não está vazio is-not-empty

A função isNotEmpty é usada para determinar se uma cadeia de caracteres não está vazia.

Sintaxe

{= isNotEmpty(string) %}: boolean

Exemplo

A função a seguir retornará 'true' se o número de telefone celular do perfil não estiver vazio. Caso contrário, retornará 'false'.

{%= isNotEmpty(profile.mobilePhone.number) %}

Último índice de last-index-of

A função lastIndexOf é usada para retornar a posição (no primeiro argumento) da última ocorrência do segundo parâmetro. Retorna -1 se não houver correspondência.

Sintaxe

{= lastIndexOf(STRING_1, STRING_2) %}: integer

Exemplo

{%= lastIndexOf("hello world","o" ) %}

Retorna 7.

Cortar à esquerda leftTrim

A função leftTrim é usada para remover espaços em branco do início de uma cadeia de caracteres.

Sintaxe

{%= leftTrim(string) %}

Comprimento length

A função length é usada para obter o número de caracteres em uma cadeia de caracteres ou expressão.

Sintaxe

{%= length(string) %}

Exemplo

A função a seguir retorna o comprimento do nome da cidade do perfil.

{%= length(profile.homeAddress.city) %}

Curtir like

A função like é usada para determinar se uma cadeia de caracteres corresponde a um padrão especificado.

Sintaxe

{%= like(STRING_1, STRING_2) %}

Exemplo

A consulta a seguir recupera todas as cidades em que os perfis vivem contendo o padrão "es".

{%= like(profile.homeAddress.city, "%es%")%}

Minúsculas lower

A função lowerCase converte uma cadeia de caracteres em letras minúsculas.

Sintaxe

{%= lowerCase(string) %}

Exemplo

Essa função converte o nome do perfil em letras minúsculas.

{%= lowerCase(profile.person.name.firstName) %}

Corresponde matches

A função matches é usada para determinar se uma sequência de caracteres corresponde a uma expressão regular específica. Consulte este documento para obter mais informações sobre padrões correspondentes em expressões regulares.

Sintaxe

{%= matches(STRING_1, STRING_2) %}

Exemplo

A consulta a seguir determina, sem distinção entre maiúsculas e minúsculas, se o nome da pessoa começa com "John".

{%= matches(person.name.,"(?i)^John") %}

Mascarar mask

A função Mask é usada para substituir uma parte de uma cadeia de caracteres por caracteres "X".

Sintaxe

{%= mask(string,integer,integer) %}

Exemplo

A consulta a seguir substitui a sequência "123456789" por caracteres "X", com exceção do primeiro e dos últimos 2 caracteres.

{%= mask("123456789",1,2) %}

A consulta retorna 1XXXXXX89.

MD5 md5

A função md5 é usada para calcular e retornar o hash md5 de uma cadeia de caracteres.

Sintaxe

{%= md5(string) %}: string

Exemplo

{%= md5("hello world") %}

Retorna "5eb63bbbbe01eed093cb22bb8f5acdc3"

Não é igual a notEqualTo

A função notEqualTo é usada para determinar se uma cadeia de caracteres não é igual à cadeia especificada.

Sintaxe

{%= notEqualTo(STRING_1, STRING_2) %}

Exemplo

A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa não é "John".

{%= notEqualTo(profile.person.name,"John") %}

Não é igual a sem diferenciar maiúsculas e minúsculas not-equal-with-ignore-case

A função notEqualWithIgnoreCase é usada para comparar duas cadeias de caracteres ignorando maiúsculas e minúsculas.

Sintaxe

{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean

Exemplo

A consulta a seguir determina se o nome da pessoa não é "john", sem distinção entre maiúsculas e minúsculas.

{%= notEqualTo(profile.person.name,"john") %}

Grupo de expressão regular regexGroup

A função Group é usada para extrair informações específicas, com base na expressão regular fornecida.

Sintaxe

{%= regexGroup(STRING, EXPRESSION, GROUP) %}

Exemplo

A consulta a seguir é usada para extrair o nome de domínio de um endereço de email.

{%= regexGroup(emailAddress,"@(\\w+)", 1) %}

Substituir replace

A função replace é usada para substituir uma determinada substring em uma string por outra substring.

Sintaxe

{%= replace(STRING_1,STRING_2,STRING_3) %}:string

Exemplo

{%= replace("Hello John, here is your monthly newsletter!","John","Mark") %}

Retorna "Olá Mark, aqui está seu informativo mensal!"

Substituir tudo replaceAll

A função replaceAll é usada para substituir todas as subsequências de um texto que corresponde à expressão "regex" pela sequência literal "replacement" especificada. O Regex tem manipulação especial de "" e "+" e todas as expressões regex seguem a estratégia de escape do PQL. A substituição continua do início da string até o fim. Por exemplo, substituir "aa" por "b" na string "aaa" resultará em "ba" em vez de "ab".

Sintaxe

{%= replaceAll(string,string,string) %}

Cortar à direita rightTrim

A função rightTrim é usada para remover espaços em branco do final de uma cadeia de caracteres.

Sintaxe

{%= rightTrim(string) %}

Divisão split

A função split é usada para dividir uma cadeia de caracteres por um determinado caractere.

Sintaxe

{%= split(string,string) %}

Inicia com startsWith

A função startsWith é usada para determinar se uma sequência de caracteres inicia com uma subsequência especificada.

Sintaxe

{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

Exemplo

A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa começa com "Joe".

{%= startsWith(person.name,"Joe") %}

String para data string-to-date

A função stringToDate converte um valor de cadeia de caracteres em um valor de data-hora. Leva dois argumentos: representação de string de uma representação de data-hora e representação de string do formatador.

Sintaxe

{= stringToDate("date-time value","formatter" %}

Exemplo

{= stringToDate("2023-01-10 23:13:26", "yyyy-MM-dd HH:mm:ss") %}

String para número inteiro string-to-integer

A função string_to_integer é usada para converter um valor de cadeia de caracteres em um valor inteiro.

Sintaxe

{= string_to_integer(string) %}: int

String para número string-to-number

A função stringToNumber é usada para converter uma cadeia de caracteres em número. Ele retorna a mesma string que a saída para entrada inválida.

Sintaxe

{%= stringToNumber(string) %}: double

Substring sub-string

A função Count string é usada para retornar a subcadeia de caracteres da expressão de cadeia de caracteres entre o índice inicial e o índice final.
Sintaxe

{= substr(string, integer, integer) %}: string

Primeira letra da palavra maiúscula titleCase

A função titleCase é usada para colocar as primeiras letras de cada palavra de uma cadeia de caracteres em maiúsculas.

Sintaxe

{%= titleCase(string) %}

Exemplo

Se a pessoa morar na Washington High Street, essa função retornará a Washington High Street.

{%= titleCase(profile.person.location.Street) %}

Para booleano to-bool

A função toBool é usada para converter um valor de argumento em um valor booleano, dependendo de seu tipo.

Sintaxe

{= toBool(string) %}: boolean

Para data hora to-date-time

A função toDateTime é usada para converter a cadeia de caracteres em data. Retorna a data da época como saída para entrada inválida.

Sintaxe

{%= toDateTime(string, string) %}: date-time

Somente para data e hora to-date-time-only

A função toDateTimeOnly é usada para converter um valor de argumento em um valor somente de data e hora. Retorna a data da época como saída para entrada inválida. Esta função aceita os tipos de campo string, date, long e int.

Sintaxe

{%= toDateTimeOnly(string/date/long/int) %}: date-time

Cortar trim

A função trim remove todos os espaços em branco do início e do fim de uma cadeia de caracteres.

Sintaxe

{%= trim(string) %}

Maiúscula upper

A função upperCase converte uma cadeia de caracteres em letras maiúsculas.

Sintaxe

{%= upperCase(string) %}

Exemplo

Esta função converte o sobrenome do perfil em letras maiúsculas.

{%= upperCase(profile.person.name.lastName) %}

Decodificação de URL url-decode

A função urlDecode é usada para decodificar uma cadeia de caracteres codificada em URL.

Sintaxe

{%= urlDecode(string) %}: string

Codificação de URL url-encode

A função Count only null é usada para codificar uma cadeia de caracteres em URL.

Sintaxe

{%= urlEncode(string) %}: string