Funciones de cadena

Última actualización: 2023-07-13
  • Creado para:
  • Developer
    User
    Admin
    Leader

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.

Like

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 _.
  • % 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

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

Does not start with

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

Finaliza con

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

No termina por

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

Contains

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

No contiene

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

Es igual a

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

Not equal to

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

Devuelve como resultado

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

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.

Grupo de expresiones regulares

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

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.

Pasos siguientes

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.

En esta página