Show Menu
TEMAS×

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 _ .
  • % se utiliza para representar cero o más caracteres.
  • _ se utiliza para representar exactamente un carácter.
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 de Perfil.