Funções de string
Profile Query Language O (PQL) oferece funções para simplificar a interação com strings. Mais informações sobre outras funções PQL podem ser encontradas no Profile Query Language visão geral.
Curtir
A variável like é usada para determinar se uma sequência de caracteres corresponde a um padrão especificado.
Formato
{STRING_1} like {STRING_2}
{STRING_1}{STRING_2}A expressão que deve corresponder à primeira sequência. Há dois caracteres especiais suportados para criar uma expressão: % e _.
%é usado para representar zero ou mais caracteres._é usado para representar exatamente um caractere.
Exemplo
A consulta PQL a seguir recupera todas as cidades que contêm o padrão "es".
city like "%es%"
Começa com
A variável startsWith é usada para determinar se uma sequência de caracteres inicia com uma subsequência especificada.
Formato
{STRING_1}.startsWith({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemplo
A consulta PQL a seguir determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa começa com "Joe".
person.name.startsWith("Joe")
Does not start with
A variável doesNotStartWith é usada para determinar se uma sequência de caracteres não inicia com uma subsequência especificada.
Formato
{STRING_1}.doesNotStartWith({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemplo
A consulta PQL a seguir determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa não começa com "Joe".
person.name.doesNotStartWith("Joe")
Termina com
A variável endsWith é usada para determinar se uma sequência de caracteres termina com uma subsequência especificada.
Formato
{STRING_1}.endsWith({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemplo
A consulta PQL a seguir 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 variável doesNotEndWith é usada para determinar se uma sequência de caracteres não termina com uma subsequência especificada.
Formato
{STRING_1}.doesNotEndWith({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemplo
A consulta PQL 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".
person.emailAddress.doesNotEndWith(".com")
Contains
A variável contains é usada para determinar se uma sequência de caracteres contém uma subsequência especificada.
Formato
{STRING_1}.contains({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemplo
A consulta PQL a seguir determina, com distinção entre maiúsculas e minúsculas, se o endereço de email da pessoa contém a cadeia de caracteres "2010@gm".
person.emailAddress.contains("2010@gm")
Não contém
A variável doesNotContain é usada para determinar se uma sequência de caracteres não contém uma subsequência especificada.
Formato
{STRING_1}.doesNotContain({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemplo
A consulta PQL 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".
person.emailAddress.doesNotContain("2010@gm")
Igual a
A variável equals é usada para determinar se uma sequência de caracteres é igual à sequência especificada.
Formato
{STRING_1}.equals({STRING_2})
{STRING_1}{STRING_2}Exemplo
A consulta PQL a seguir determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa é "John".
person.name.equals("John")
Not equal to
A variável notEqualTo é usada para determinar se uma sequência de caracteres não é igual à sequência especificada.
Formato
{STRING_1}.notEqualTo({STRING_2})
{STRING_1}{STRING_2}Exemplo
A consulta PQL a seguir determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa não é "John".
person.name.notEqualTo("John")
Corresponde
A variável 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.
Formato
{STRING_1}.matches(STRING_2})
Exemplo
A consulta PQL a seguir determina, sem diferenciar maiúsculas de minúsculas, se o nome da pessoa começa com "John".
person.name.matches("(?i)^John")
\w, você deve escape do caractere de barra invertida. Então, em vez de escrever apenas \w, você deve incluir uma barra invertida e uma gravação extras \\w.Grupo de expressão regular
A variável regexGroup é usada para extrair informações específicas, com base na expressão regular fornecida.
Formato
{STRING}.regexGroup({EXPRESSION})
Exemplo
A consulta PQL a seguir é usada para extrair o nome de domínio de um endereço de email.
emailAddress.regexGroup("@(\\w+)", 1)
\w, você deve escape do caractere de barra invertida. Então, em vez de escrever apenas \w, você deve incluir uma barra invertida e uma gravação extras \\w.Próximas etapas
Agora que você aprendeu sobre funções de string, é possível usá-las em consultas PQL. Para obter mais informações sobre outras funções PQL, leia o Visão geral do idioma de consulta do perfil.