Show Menu
TÓPICOS×

Funções de string

Linguagem do Query do Perfil (PQL) oferta funciona para simplificar a interação com strings. Para obter mais informações sobre outras funções PQL, consulte a visão geral do idioma do Query do Perfil.

Curtir

A like função é usada para determinar se uma string corresponde a um padrão especificado.
Formato
{STRING_1} like {STRING_2}

Argumento
Descrição
{STRING_1}
A string para executar a verificação.
{STRING_2}
A expressão para corresponder à primeira string. Há dois caracteres especiais suportados para criar uma expressão: % e _ .
  • % é usada para representar zero ou mais caracteres.
  • _ é usada para representar exatamente um caractere.
Exemplo
O seguinte query PQL recupera todas as cidades que contêm o padrão "es".
city like "%es%"

Começa com

A startsWith função é usada para determinar se uma string start com uma substring especificada.
Formato
{STRING_1}.startsWith({STRING_2}, {BOOLEAN})

Argumento
Descrição
{STRING_1}
A string para executar a verificação.
{STRING_2}
A string a ser procurada na primeira string.
{BOOLEAN}
Um parâmetro opcional para determinar se a verificação faz distinção entre maiúsculas e minúsculas. Por padrão, isso é definido como true.
Exemplo
O seguinte query PQL determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa start com "Joe".
person.name.startsWith("Joe")

Does not start with

A doesNotStartWith função é usada para determinar se uma string não é start com uma substring especificada.
Formato
{STRING_1}.doesNotStartWith({STRING_2}, {BOOLEAN})

Argumento
Descrição
{STRING_1}
A string para executar a verificação.
{STRING_2}
A string a ser procurada na primeira string.
{BOOLEAN}
Um parâmetro opcional para determinar se a verificação faz distinção entre maiúsculas e minúsculas. Por padrão, isso é definido como true.
Exemplo
O seguinte query PQL determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa não start com "Joe".
person.name.doesNotStartWith("Joe")

Termina com

A endsWith função é usada para determinar se uma string termina com uma substring especificada.
Formato
{STRING_1}.endsWith({STRING_2}, {BOOLEAN})

Argumento
Descrição
{STRING_1}
A string para executar a verificação.
{STRING_2}
A string a ser procurada na primeira string.
{BOOLEAN}
Um parâmetro opcional para determinar se a verificação faz distinção entre maiúsculas e minúsculas. Por padrão, isso é definido como true.
Exemplo
O seguinte query PQL determina, com distinção entre maiúsculas e minúsculas, se o endereço de email da pessoa termina com ".com".
person.emailAddress.endsWith(".com")

Não termina com

A doesNotEndWith função é usada para determinar se uma string não termina com uma substring especificada.
Formato
{STRING_1}.doesNotEndWith({STRING_2}, {BOOLEAN})

Argumento
Descrição
{STRING_1}
A string para executar a verificação.
{STRING_2}
A string a ser procurada na primeira string.
{BOOLEAN}
Um parâmetro opcional para determinar se a verificação faz distinção entre maiúsculas e minúsculas. Por padrão, isso é definido como true.
Exemplo
O seguinte query PQL determina, com distinção entre maiúsculas e minúsculas, se o endereço de email da pessoa não termina com ".com".
person.emailAddress.doesNotEndWith(".com")

Contém

A contains função é usada para determinar se uma string contém uma substring especificada.
Formato
{STRING_1}.contains({STRING_2}, {BOOLEAN})

Argumento
Descrição
{STRING_1}
A string para executar a verificação.
{STRING_2}
A string a ser procurada na primeira string.
{BOOLEAN}
Um parâmetro opcional para determinar se a verificação faz distinção entre maiúsculas e minúsculas. Por padrão, isso é definido como true.
Exemplo
O seguinte query PQL determina, com distinção entre maiúsculas e minúsculas, se o endereço de email da pessoa contém a string "2010@gm".
person.emailAddress.contains("2010@gm")

Não contém

A doesNotContain função é usada para determinar se uma string não contém uma substring especificada.
Formato
{STRING_1}.doesNotContain({STRING_2}, {BOOLEAN})

Argumento
Descrição
{STRING_1}
A string para executar a verificação.
{STRING_2}
A string a ser procurada na primeira string.
{BOOLEAN}
Um parâmetro opcional para determinar se a verificação faz distinção entre maiúsculas e minúsculas. Por padrão, isso é definido como true.
Exemplo
O seguinte query PQL determina, com distinção entre maiúsculas e minúsculas, se o endereço de email da pessoa não contém a string "2010@gm".
person.emailAddress.doesNotContain("2010@gm")

Igual

A equals função é usada para determinar se uma string é igual à string especificada.
Formato
{STRING_1}.equals({STRING_2})

Argumento
Descrição
{STRING_1}
A string para executar a verificação.
{STRING_2}
A string a ser comparada com a primeira string.
Exemplo
O seguinte query PQL determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa é "John".
person.name.equals("John")

Not equal to

A notEqualTo função é usada para determinar se uma string não é igual à string especificada.
Formato
{STRING_1}.notEqualTo({STRING_2})

Argumento
Descrição
{STRING_1}
A string para executar a verificação.
{STRING_2}
A string a ser comparada com a primeira string.
Exemplo
O seguinte query PQL determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa não é "John".
person.name.notEqualTo("John")

Corresponde

A matches função é usada para determinar se uma string corresponde a uma expressão regular específica. Consulte este documento para obter mais informações sobre padrões correspondentes em expressões regulares.
Formato
{STRING_1}.matches(STRING_2})

Exemplo
O seguinte query PQL determina, sem distinção entre maiúsculas e minúsculas, se o nome da pessoa start com "John".
person.name.matches("(?i)^John")

Grupo de expressões regular

A regexGroup função é usada para extrair informações específicas, com base na expressão regular fornecida.
Formato
{STRING}.regexGroup({EXPRESSION})

Exemplo
O seguinte query PQL é usado para extrair o nome do domínio de um endereço de email.
emailAddress.regexGroup("@(\w+)", 1)

Próximas etapas

Agora que você aprendeu sobre funções de sequência de caracteres, é possível usá-las em seus query PQL. Para obter mais informações sobre outras funções PQL, leia a visão geral do Idioma do Query do Perfil.