Profile Query Language (PQL) ofrece funciones para facilitar la interacción con cadenas. Puede encontrar más información sobre otras funciones PQL en la Profile Query Language descripción general.
El like
se utiliza para determinar si una cadena coincide con un patrón especificado.
Formato
{STRING_1} like {STRING_2}
Argumento | Descripción |
---|---|
{STRING_1} |
Cadena en la que se realizará la comprobación. |
{STRING_2} |
La expresión que debe coincidir con la primera cadena. Existen dos caracteres especiales admitidos para crear una expresión: % y _ .
|
Ejemplo
La siguiente consulta PQL recupera todas las ciudades que contienen el patrón "es".
city like "%es%"
El startsWith
se utiliza para determinar si una cadena empieza con una subcadena especificada.
Formato
{STRING_1}.startsWith({STRING_2}, {BOOLEAN})
Argumento | Descripción |
---|---|
{STRING_1} |
Cadena en la que se realizará la comprobación. |
{STRING_2} |
Cadena que se busca dentro de la primera cadena. |
{BOOLEAN} |
Un parámetro opcional para determinar si la comprobación distingue entre mayúsculas y minúsculas. De forma predeterminada, se establece en true. |
Ejemplo
La siguiente consulta PQL determina, con distinción de mayúsculas y minúsculas, si el nombre de la persona comienza con "Joe".
person.name.startsWith("Joe")
El doesNotStartWith
se utiliza para determinar si una cadena no comienza con una subcadena especificada.
Formato
{STRING_1}.doesNotStartWith({STRING_2}, {BOOLEAN})
Argumento | Descripción |
---|---|
{STRING_1} |
Cadena en la que se realizará la comprobación. |
{STRING_2} |
Cadena que se busca dentro de la primera cadena. |
{BOOLEAN} |
Un parámetro opcional para determinar si la comprobación distingue entre mayúsculas y minúsculas. De forma predeterminada, se establece en true. |
Ejemplo
La siguiente consulta PQL determina, con distinción de mayúsculas y minúsculas, si el nombre de la persona no comienza con "Joe".
person.name.doesNotStartWith("Joe")
El endsWith
se utiliza para determinar si una cadena termina con una subcadena especificada.
Formato
{STRING_1}.endsWith({STRING_2}, {BOOLEAN})
Argumento | Descripción |
---|---|
{STRING_1} |
Cadena en la que se realizará la comprobación. |
{STRING_2} |
Cadena que se busca dentro de la primera cadena. |
{BOOLEAN} |
Un parámetro opcional para determinar si la comprobación distingue entre mayúsculas y minúsculas. De forma predeterminada, se establece en true. |
Ejemplo
La siguiente consulta PQL determina, con distinción de mayúsculas y minúsculas, si la dirección de correo electrónico de la persona termina con ".com".
person.emailAddress.endsWith(".com")
El doesNotEndWith
se utiliza para determinar si una cadena no termina con una subcadena especificada.
Formato
{STRING_1}.doesNotEndWith({STRING_2}, {BOOLEAN})
Argumento | Descripción |
---|---|
{STRING_1} |
Cadena en la que se realizará la comprobación. |
{STRING_2} |
Cadena que se busca dentro de la primera cadena. |
{BOOLEAN} |
Un parámetro opcional para determinar si la comprobación distingue entre mayúsculas y minúsculas. De forma predeterminada, se establece en true. |
Ejemplo
La siguiente consulta PQL determina, con distinción de mayúsculas y minúsculas, si la dirección de correo electrónico de la persona no termina con ".com".
person.emailAddress.doesNotEndWith(".com")
El contains
se utiliza para determinar si una cadena contiene una subcadena especificada.
Formato
{STRING_1}.contains({STRING_2}, {BOOLEAN})
Argumento | Descripción |
---|---|
{STRING_1} |
Cadena en la que se realizará la comprobación. |
{STRING_2} |
Cadena que se busca dentro de la primera cadena. |
{BOOLEAN} |
Un parámetro opcional para determinar si la comprobación distingue entre mayúsculas y minúsculas. De forma predeterminada, se establece en true. |
Ejemplo
La siguiente consulta PQL determina, con distinción de mayúsculas y minúsculas, si la dirección de correo electrónico de la persona contiene la cadena "2010@gm".
person.emailAddress.contains("2010@gm")
El doesNotContain
se utiliza para determinar si una cadena no contiene una subcadena especificada.
Formato
{STRING_1}.doesNotContain({STRING_2}, {BOOLEAN})
Argumento | Descripción |
---|---|
{STRING_1} |
Cadena en la que se realizará la comprobación. |
{STRING_2} |
Cadena que se busca dentro de la primera cadena. |
{BOOLEAN} |
Un parámetro opcional para determinar si la comprobación distingue entre mayúsculas y minúsculas. De forma predeterminada, se establece en true. |
Ejemplo
La siguiente consulta PQL determina, con distinción de mayúsculas y minúsculas, si la dirección de correo electrónico de la persona no contiene la cadena "2010@gm".
person.emailAddress.doesNotContain("2010@gm")
El equals
se utiliza para determinar si una cadena es igual a la cadena especificada.
Formato
{STRING_1}.equals({STRING_2})
Argumento | Descripción |
---|---|
{STRING_1} |
Cadena en la que se realizará la comprobación. |
{STRING_2} |
Cadena que se va a comparar con la primera cadena. |
Ejemplo
La siguiente consulta PQL determina, con distinción de mayúsculas y minúsculas, si el nombre de la persona es "John".
person.name.equals("John")
El notEqualTo
se utiliza para determinar si una cadena no es igual a la cadena especificada.
Formato
{STRING_1}.notEqualTo({STRING_2})
Argumento | Descripción |
---|---|
{STRING_1} |
Cadena en la que se realizará la comprobación. |
{STRING_2} |
Cadena que se va a comparar con la primera cadena. |
Ejemplo
La siguiente consulta PQL determina, con distinción de mayúsculas y minúsculas, si el nombre de la persona no es "John".
person.name.notEqualTo("John")
El matches
se utiliza para determinar si una cadena coincide con una expresión regular específica. Consulte la este documento para obtener más información sobre los patrones de coincidencia en expresiones regulares.
Formato
{STRING_1}.matches(STRING_2})
Ejemplo
La siguiente consulta PQL determina, sin distinguir entre mayúsculas y minúsculas, si el nombre de la persona comienza con "John".
person.name.matches("(?i)^John")
Si utiliza funciones de expresión regular como \w
, usted debe escape del carácter de barra invertida. Así que, en lugar de escribir sólo \w
, debe incluir una barra invertida y una escritura adicionales \\w
.
El regexGroup
se utiliza para extraer información específica, basada en la expresión regular proporcionada.
Formato
{STRING}.regexGroup({EXPRESSION})
Ejemplo
La siguiente consulta PQL se utiliza para extraer el nombre de dominio de una dirección de correo electrónico.
emailAddress.regexGroup("@(\\w+)", 1)
Si utiliza funciones de expresión regular como \w
, usted debe escape del carácter de barra invertida. Así que, en lugar de escribir sólo \w
, debe incluir una barra invertida y una escritura adicionales \\w
.
Ahora que ha aprendido acerca de las funciones de cadena, puede utilizarlas en sus consultas PQL. Para obtener más información sobre otras funciones PQL, lea la Introducción al lenguaje de consulta de perfil.