Funciones de cadena

Aprenda a utilizar funciones de cadena en el editor de expresiones.

Camello

La variable camelCase pone en mayúscula la primera letra de cada palabra de una cadena.

Formato

{%= camelCase(string)%}

Ejemplo

La siguiente función pone en mayúscula la primera letra de la palabra en la dirección del perfil.

{%= camelCase(profile.homeAddress.street) %}

Concat

La variable concat combina dos cadenas en una.

Formato

{%= concat(string,string) %}

Ejemplo

La siguiente función combinará ciudad y país del perfil en una sola cadena.

{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}

Contains

La variable contains para determinar si una cadena contiene una subcadena especificada.

Formato

{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}
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.
CASE_SENSITIVE Un parámetro opcional para determinar si la comprobación distingue entre mayúsculas y minúsculas. Valores posibles: true (predeterminado) / false.

Ejemplos

  • La siguiente función comprobará si el nombre del perfil contiene la letra A (en mayúsculas o minúsculas). Si este es el caso, devolverá 'true', de lo contrario devolverá 'false'.

    {%= contains(profile.person.name.firstName, "A", false) %}
    
  • La siguiente consulta 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".

    {%= contains(profile.person.emailAddress,"2010@gm") %}
    

No contiene

La variable doesNotContain para determinar si una cadena no contiene una subcadena especificada.

Formato

{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}
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.
CASE_SENSITIVE Un parámetro opcional para determinar si la comprobación distingue entre mayúsculas y minúsculas. Valores posibles: true (predeterminado) / false.

Ejemplo

La siguiente consulta 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".

{%= doesNotContain(profile.person.emailAddress,"2010@gm")%}

No termina con

La variable doesNotEndWith se utiliza para determinar si una cadena no termina con una subcadena especificada.

Formato

{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
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.
{CASE_SENSITIVE} Un parámetro opcional para determinar si la comprobación distingue entre mayúsculas y minúsculas. Valores posibles: true (predeterminado) / false.

Ejemplo

La siguiente consulta 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".

doesNotEndWith(person.emailAddress,".com")

Does not start with

La variable doesNotStartWith para determinar si una cadena no comienza con una subcadena especificada.

Formato

{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
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.
{CASE_SENSITIVE} Un parámetro opcional para determinar si la comprobación distingue entre mayúsculas y minúsculas. Valores posibles: true (predeterminado) / false.

Ejemplo

La siguiente consulta determina, con distinción de mayúsculas y minúsculas, si el nombre de la persona no comienza con "Joe".

{%= doesNotStartWith(person.name,"Joe")%}

Codificar 64

La variable encode64 se utiliza para codificar una cadena para conservar la información personal (PI) si se va a incluir, por ejemplo, en una dirección URL.

Formato

{%= encode64(string) %}

Finaliza con

La variable endsWith para determinar si una cadena termina con una subcadena especificada.

Formato

{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
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.
{CASE_SENSITIVE} Un parámetro opcional para determinar si la comprobación distingue entre mayúsculas y minúsculas. Valores posibles: true (predeterminado) / false.

Ejemplo

La siguiente consulta determina, con distinción de mayúsculas y minúsculas, si la dirección de correo electrónico de la persona termina en ".com".

{%= endsWith(person.emailAddress,".com") %}

Es igual a

La variable equals se utiliza para determinar si una cadena es igual a la cadena especificada, con distinción entre mayúsculas y minúsculas.

Formato

{%= equals(STRING_1, 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 determina, con distinción de mayúsculas y minúsculas, si el nombre de la persona es "John".

{%=equals(profile.person.name,"John") %}

Es igual a omitir mayúsculas y minúsculas

La variable equalsIgnoreCase para determinar si una cadena es igual a la cadena especificada, sin distinción de mayúsculas y minúsculas.

Formato

{%= equalsIgnoreCase(STRING_1, 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 determina, sin distinción de mayúsculas y minúsculas, si el nombre de la persona es "John".

{%= equalsIgnoreCase(profile.person.name,"John") %}

Extraer dominio de correo electrónico

La variable extractEmailDomain se utiliza para extraer el dominio de una dirección de correo electrónico.

Formato

{%= extractEmailDomain(string) %}

Ejemplo

La siguiente consulta extrae el dominio de correo electrónico de la dirección de correo electrónico personal.

{%= extractEmailDomain(profile.personalEmail.address) %}

Obtener host de URL

La variable getUrlHost se utiliza para recuperar el nombre de host de una URL.

Formato

{%= getUrlHost(string) %}: string

Ejemplo

{%= getUrlHost("http://www.myurl.com/contact") %}

Devuelve "www.myurl.com"

Obtener ruta de URL

La variable getUrlPath se utiliza para recuperar la ruta después del nombre de dominio de una dirección URL.

Formato

{%= getUrlPath(string) %}: string

Ejemplo

{%= getUrlPath("http://www.myurl.com/contact.html") %}

Devuelve "/contact.html"

Obtener protocolo de url

La variable getUrlProtocol se utiliza para recuperar el protocolo de una URL.

Formato

{%= getUrlProtocol(string) %}: string

Ejemplo

{%= getUrlProtocol("http://www.myurl.com/contact.html") %}

Devuelve "http"

Índice de

La variable indexOf se utiliza para devolver la posición (en el primer argumento) de la primera incidencia del segundo parámetro. Devuelve -1 si no hay coincidencia.

Formato

{%= indexOf(STRING_1, STRING_2) %}: integer
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 en el primer parámetro

Ejemplo

{%= indexOf("hello world","world" ) %}

Devuelve 6.

Is empty

La variable isEmpty para determinar si una cadena está vacía.

Formato

{%= isEmpty(string) %}

Ejemplo

La siguiente función devuelve 'true' si el número de teléfono móvil del perfil está vacío. De lo contrario, devolverá 'false'.

{%= isEmpty(profile.mobilePhone.number) %}

Is Not Empty

La variable isNotEmpty para determinar si una cadena no está vacía.

Formato

{= isNotEmpty(string) %}: boolean

Ejemplo

La siguiente función devuelve 'true' si el número de teléfono móvil del perfil no está vacío. De lo contrario, devolverá 'false'.

{%= isNotEmpty(profile.mobilePhone.number) %}

Último índice de

La variable lastIndexOf se utiliza para devolver la posición (en el primer argumento) de la última incidencia del segundo parámetro. Devuelve -1 si no hay coincidencia.

Formato

{= lastIndexOf(STRING_1, STRING_2) %}: integer
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 en el primer parámetro

Ejemplo

{%= lastIndexOf("hello world","o" ) %}

Devuelve 7.

Guarnecido izquierdo

La variable leftTrim se utiliza para eliminar los espacios en blanco del principio de una cadena.

Formato

{%= leftTrim(string) %}

Length

La variable length se utiliza para obtener el número de caracteres de una cadena o una expresión.

Formato

{%= length(string) %}

Ejemplo

La siguiente función devuelve la longitud del nombre de ciudad del perfil.

{%= length(profile.homeAddress.city) %}

Like

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

Formato

{%= like(STRING_1, 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 recupera todas las ciudades donde viven los perfiles que contienen el patrón "es".

{%= like(profile.homeAddress.city, "%es%")%}

Lower Case

La variable lowerCase convierte una cadena en minúsculas.

Sintaxis

{%= lowerCase(string) %}

Ejemplo

Esta función convierte el nombre del perfil en letras minúsculas.

{%= lowerCase(profile.person.name.firstName) %}

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

{%= matches(STRING_1, STRING_2) %}

Ejemplo

La siguiente consulta determina, sin distinción de mayúsculas y minúsculas, si el nombre de la persona empieza por "John".

{%= matches(person.name.,"(?i)^John") %}

Máscara

La variable Mask se utiliza para reemplazar una parte de una cadena con caracteres "X".

Formato

{%= mask(string,integer,integer) %}

Ejemplo

La siguiente consulta reemplaza la cadena "123456789" por caracteres "X", excepto para los dos primeros y últimos caracteres.

{%= mask("123456789",1,2) %}

La consulta devuelve 1XXXXXX89.

MD5

La variable md5 se utiliza para calcular y devolver el hash md5 de una cadena.

Formato

{%= md5(string) %}: string

Ejemplo

{%= md5("hello world") %}

Devuelve "5eb63bbbe01eed093cb22bb8f5acdc3"

Not equal to

La variable notEqualTo para determinar si una cadena no es igual a la cadena especificada.

Formato

{%= notEqualTo(STRING_1, 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 determina, con distinción de mayúsculas y minúsculas, si el nombre de la persona no es "John".

{%= notEqualTo(profile.person.name,"John") %}

Distinto de mayúsculas y minúsculas ignoradas

La variable notEqualWithIgnoreCase se utiliza para comparar dos cadenas que ignoran mayúsculas y minúsculas.

Formato

{= notEqualWithIgnoreCase(STRING_1,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 comparar con la primera cadena.

Ejemplo

La siguiente consulta determina si el nombre de la persona no es "john", sin distinción de mayúsculas y minúsculas.

{%= notEqualTo(profile.person.name,"john") %}

Grupo de expresiones regulares

La variable Group se utiliza para extraer información específica, según la expresión regular proporcionada.

Formato

{%= regexGroup(STRING, EXPRESSION, GROUP) %}
Argumento Descripción
{STRING} La cadena en la que se va a realizar la comprobación.
{EXPRESSION} La expresión regular que coincide con la primera cadena.
{GROUP} Grupo de expresiones con el que hacer coincidir.

Ejemplo

La siguiente consulta se utiliza para extraer el nombre de dominio de una dirección de correo electrónico.

{%= regexGroup(emailAddress,"@(\\w+)", 1) %}

Reemplazar

La variable replace se utiliza para reemplazar una subcadena determinada de una cadena por otra subcadena.

Formato

{%= replace(STRING_1,STRING_2,STRING_3) %}:string
Argumento Descripción
{STRING_1} La cadena donde se debe reemplazar la subcadena.
{STRING_2} La subcadena que se va a reemplazar.
{STRING_3} La subcadena de reemplazo.

Ejemplo

{%= replace("Hello John, here is your monthly newsletter!","John","Mark") %}

Devuelve "Hello Mark, aquí tiene su boletín mensual".

Reemplazar todo

La variable replaceAll se utiliza para reemplazar todas las subcadenas de un texto que coincida con el "destino" por la cadena de sustitución literal especificada. La sustitución procede desde el principio de la cadena hasta el final, por ejemplo, reemplazar "aa" por "b" en la cadena "aaa" resultará en "ba" en lugar de "ab".

Formato

{%= replaceAll(string,string,string) %}

Guarnecido derecho

La variable rightTrim se utiliza para eliminar los espacios en blanco del final de una cadena.

Formato

{%= rightTrim(string) %}

Split

La variable split se utiliza para dividir una cadena por un carácter determinado.

Formato

{%= split(string,string) %}

Comienza con

La variable startsWith se utiliza para determinar si una cadena comienza con una subcadena especificada.

Formato

{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
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.
{CASE_SENSITIVE} 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 determina, con distinción de mayúsculas y minúsculas, si el nombre de la persona empieza por "Joe".

{%= startsWith(person.name,"Joe") %}

Cadena a entero

La variable string_to_integer se utiliza para convertir un valor de cadena en un valor entero.

Formato

{= string_to_integer(string) %}: int

Cadena para número

La variable stringToNumber se utiliza para convertir una cadena en número. Devuelve la misma cadena que el resultado de una entrada no válida.

Formato

{%= stringToNumber(string) %}: double

Subcadena

La variable Count string se utiliza para devolver la subcadena de la expresión de cadena entre el índice begin y el índice end.
Formato

{= substr(string, integer, integer) %}: string

Caso de título

La variable titleCase se utiliza para poner en mayúsculas las primeras letras de cada palabra de una cadena.

Sintaxis

{%= titleCase(string) %}

Ejemplo

Si la persona vive en Washington High Street, esta función regresará a Washington High Street.

{%= titleCase(profile.person.location.Street) %}

A Bool

La variable toBool se utiliza para convertir un valor de argumento en un valor booleano, según su tipo.

Formato

{= toBool(string) %}: boolean

Hasta la fecha

La variable toDateTime se utiliza para convertir cadena a fecha. Devuelve la fecha de epoch como salida para una entrada no válida.

Formato

{%= toDateTime(string, string) %}: date-time

Hasta fecha solamente

La variable toDateTimeOnly se utiliza para convertir un valor de argumento en un valor de solo fecha y hora. Devuelve la fecha de epoch como salida para una entrada no válida.

Formato

{%= toDateTimeOnly(string) %}: date-time

Recortar

La variable trim elimina todos los espacios en blanco del principio y del final de una cadena.

Sintaxis

{%= trim(string) %}

Mayúsculas

La variable upperCase convierte una cadena en mayúsculas.

Sintaxis

{%= upperCase(string) %}

Ejemplo

Esta función convierte los apellidos del perfil en mayúsculas.

{%= upperCase(profile.person.name.lastName) %}

descodificación de url

La variable urlDecode se utiliza para decodificar una cadena con codificación url.

Formato

{%= urlDecode(string) %}: string

Codificación de URL

La variable Count only null para codificar una cadena.

Formato

{%= urlEncode(string) %}: string

En esta página