Funções de string
O Profile Query Language (PQL) oferece funções para simplificar a interação com cadeias de caracteres. Mais informações sobre outras funções do PQL podem ser encontradas na Profile Query Language visão geral.
Curtir
A função like é usada para determinar se uma cadeia de caracteres corresponde a um padrão especificado como booleano.
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 a criação de 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%"
Inicia com
A função startsWith é usada para determinar se uma sequência de caracteres inicia com uma subsequência especificada como booleana.
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")
Não inicia com
A função doesNotStartWith é usada para determinar se uma cadeia de caracteres não inicia com uma subcadeia especificada como booleana.
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 função endsWith é usada para determinar se uma sequência de caracteres termina com uma subsequência especificada como booleana.
Formato
{STRING_1}.endsWith({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemplo
A consulta do 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 função doesNotEndWith é usada para determinar se uma cadeia de caracteres não termina com uma subcadeia especificada como booleana.
Formato
{STRING_1}.doesNotEndWith({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemplo
A consulta do 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 função contains é usada para determinar se uma cadeia de caracteres contém uma subsequência especificada como booleana.
Formato
{STRING_1}.contains({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemplo
A consulta do 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 função doesNotContain é usada para determinar se uma cadeia de caracteres não contém uma subsequência especificada como booleana.
Formato
{STRING_1}.doesNotContain({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemplo
A consulta do 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 função equals é usada para determinar se uma cadeia de caracteres é igual à cadeia de caracteres especificada como booleana.
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")
Não é igual a
A função notEqualTo é usada para determinar se uma cadeia de caracteres não é igual à cadeia de caracteres especificada como booleana.
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 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 como booleano.
Formato
{STRING_1}.matches(STRING_2})
Exemplo
A consulta do 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, deverá escapar do caractere de barra invertida. Então, em vez de escrever apenas \w, você deve incluir uma barra invertida extra e escrever \\w.Grupo de expressão regular
A função regexGroup é usada para extrair informações específicas, com base na expressão regular fornecida como uma cadeia de caracteres.
Formato
{STRING}.regexGroup({EXPRESSION})
Exemplo
A consulta do PQL a seguir é usada para extrair o nome de domínio de um endereço de email.
emailAddress.regexGroup("@(\\w+)", 1)
\w, deverá escapar do caractere de barra invertida. Então, em vez de escrever apenas \w, você deve incluir uma barra invertida extra e escrever \\w.Próximas etapas
Agora que você aprendeu sobre funções de string, é possível usá-las em queries do PQL. Para obter mais informações sobre outras funções do PQL, leia a visão geral do Profile Query Language.