Funciones de cadena
Profile Query Language (PQL) oferta funciones para simplificar la interacción con cadenas. Encontrará más información sobre otras funciones de PQL en la Profile Query Language descripción general.
Como
La like función se utiliza para determinar si una cadena coincide con un patrón especificado.
Format
{STRING_1} like {STRING_2}
| Argumento | Descripción |
|---|---|
{STRING_1} |
La cadena en la que se va a realizar la comprobación. |
{STRING_2} |
La expresión que se va a comparar 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%"
Comienza con
La startsWith función se utiliza para determinar si una cadena inicio con una subcadena especificada.
Format
{STRING_1}.startsWith({STRING_2}, {BOOLEAN})
| Argumento | Descripción |
|---|---|
{STRING_1} |
La cadena en la que se va a realizar la comprobación. |
{STRING_2} |
La cadena que se va a buscar dentro de la primera cadena. |
{BOOLEAN} |
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 de PQL determina, con distinción de mayúsculas y minúsculas, si el nombre de la persona inicio con "Joe".
person.name.startsWith("Joe")
Does not start with
La doesNotStartWith función se utiliza para determinar si una cadena no está en inicio con una subcadena especificada.
Format
{STRING_1}.doesNotStartWith({STRING_2}, {BOOLEAN})
| Argumento | Descripción |
|---|---|
{STRING_1} |
La cadena en la que se va a realizar la comprobación. |
{STRING_2} |
La cadena que se va a buscar dentro de la primera cadena. |
{BOOLEAN} |
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 de PQL determina, con distinción de mayúsculas y minúsculas, si el nombre de la persona no inicio con "Joe".
person.name.doesNotStartWith("Joe")
Finaliza con
La endsWith función se utiliza para determinar si una cadena termina con una subcadena especificada.
Format
{STRING_1}.endsWith({STRING_2}, {BOOLEAN})
| Argumento | Descripción |
|---|---|
{STRING_1} |
La cadena en la que se va a realizar la comprobación. |
{STRING_2} |
La cadena que se va a buscar dentro de la primera cadena. |
{BOOLEAN} |
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 de PQL determina, con distinción de mayúsculas y minúsculas, si la dirección de correo electrónico de la persona termina en ".com".
person.emailAddress.endsWith(".com")
No termina con
La doesNotEndWith función se utiliza para determinar si una cadena no termina con una subcadena especificada.
Format
{STRING_1}.doesNotEndWith({STRING_2}, {BOOLEAN})
| Argumento | Descripción |
|---|---|
{STRING_1} |
La cadena en la que se va a realizar la comprobación. |
{STRING_2} |
La cadena que se va a buscar dentro de la primera cadena. |
{BOOLEAN} |
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 de PQL determina, con distinción de mayúsculas y minúsculas, si la dirección de correo electrónico de la persona no termina en ".com".
person.emailAddress.doesNotEndWith(".com")
Contains
La contains función se utiliza para determinar si una cadena contiene una subcadena especificada.
Format
{STRING_1}.contains({STRING_2}, {BOOLEAN})
| Argumento | Descripción |
|---|---|
{STRING_1} |
La cadena en la que se va a realizar la comprobación. |
{STRING_2} |
La cadena que se va a buscar dentro de la primera cadena. |
{BOOLEAN} |
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 de 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")
No contiene
La doesNotContain función se utiliza para determinar si una cadena no contiene una subcadena especificada.
Format
{STRING_1}.doesNotContain({STRING_2}, {BOOLEAN})
| Argumento | Descripción |
|---|---|
{STRING_1} |
La cadena en la que se va a realizar la comprobación. |
{STRING_2} |
La cadena que se va a buscar dentro de la primera cadena. |
{BOOLEAN} |
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 de 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")
Es igual a
La equals función se utiliza para determinar si una cadena es igual a la cadena especificada.
Format
{STRING_1}.equals({STRING_2})
| Argumento | Descripción |
|---|---|
{STRING_1} |
La cadena en la que se va a realizar la comprobación. |
{STRING_2} |
La cadena que se va a comparar con la primera cadena. |
Ejemplo
La siguiente consulta de PQL determina, con distinción de mayúsculas y minúsculas, si el nombre de la persona es "John".
person.name.equals("John")
Not equal to
La notEqualTo función se utiliza para determinar si una cadena no es igual a la cadena especificada.
Format
{STRING_1}.notEqualTo({STRING_2})
| Argumento | Descripción |
|---|---|
{STRING_1} |
La cadena en la que se va a realizar la comprobación. |
{STRING_2} |
La cadena que se va a comparar con la primera cadena. |
Ejemplo
La siguiente consulta de PQL determina, con distinción entre mayúsculas y minúsculas, si el nombre de la persona no es "John".
person.name.notEqualTo("John")
Coincide
La matches función se utiliza para determinar si una cadena coincide con una expresión regular específica. Consulte este documento para obtener más información sobre patrones coincidentes en expresiones regulares.
Format
{STRING_1}.matches(STRING_2})
Ejemplo
La siguiente consulta de PQL determina, sin distinguir entre mayúsculas y minúsculas, si el nombre de la persona inicio con "John".
person.name.matches("(?i)^John")
Grupo de expresión regular
La regexGroup función se utiliza para extraer información específica, basándose en la expresión habitual proporcionada.
Format
{STRING}.regexGroup({EXPRESSION})
Ejemplo
La siguiente consulta de PQL se utiliza para extraer el nombre de dominio de una dirección de correo electrónico.
emailAddress.regexGroup("@(\w+)", 1)
Pasos siguientes
Ahora que ha aprendido sobre las funciones de cadena, puede utilizarlas dentro de sus consultas PQL. Para obtener más información sobre otras funciones de PQL, lea la descripción general del lenguaje de Consulta dePerfil.