Funções de string

Profile Query Language (PQL) oferta funções para tornar a interação com strings mais simples. Para obter mais informações sobre outras funções PQL, consulte a Profile Query Language visão geral.

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")

Contains

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

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 doPerfil.

Nesta página