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 la Profile Query Language información general.

Like

La variable like para determinar si una cadena coincide con un patrón especificado.

Formato

{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 variable 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 variable doesNotStartWith 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 variable endsWith 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 variable 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 variable contains 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 variable doesNotContain 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 variable equals 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 variable notEqualTo 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 variable matches 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.

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")
NOTA

Si utiliza funciones de expresión regular como \w, usted must escape el carácter de barra invertida. Así que, en lugar de escribir solo \w, debe incluir una barra invertida adicional y escribir \\w.

Grupo de expresiones regulares

La variable 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)
NOTA

Si utiliza funciones de expresión regular como \w, usted must escape el carácter de barra invertida. Así que, en lugar de escribir solo \w, debe incluir una barra invertida adicional y escribir \\w.

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 sobre el lenguaje de consulta de perfil.

En esta página