Funciones de cadena

Profile Query Language (PQL) ofrece funciones para simplificar la interacción con cadenas. Puede encontrar más información sobre otras funciones de PQL en Profile Query Language overview.

Like

La función like 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 debe coincidir 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 función startsWith se utiliza para determinar si una cadena comienza con una subcadena especificada.

Formato

{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} 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 empieza por "Joe".

person.name.startsWith("Joe")

Does not start with

La función 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} 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} 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")

Finaliza con

La función 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} 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} 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 en ".com".

person.emailAddress.endsWith(".com")

No termina con

La función 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} 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} 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")

Contains

La función contains se utiliza para determinar si una cadena contiene una subcadena especificada.

Formato

{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} 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")

No contiene

La función 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} 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} 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")

Es igual a

La función 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} 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 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 función 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} 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 PQL determina, con distinción de mayúsculas y minúsculas, si el nombre de la persona no es "John".

person.name.notEqualTo("John")

Coincide

La función matches 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 los patrones coincidentes en las 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 empieza por "John".

person.name.matches("(?i)^John")

Grupo de expresiones regulares

La función regexGroup se utiliza para extraer información específica, según 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)

Pasos siguientes

Ahora que ha aprendido sobre las funciones de cadena, puede utilizarlas en sus consultas PQL. Para obtener más información sobre otras funciones de PQL, lea la información general del lenguaje de consulta de perfil.

En esta página