Funciones de cadena string

Aprenda a utilizar las funciones de cadena en el Editor de expresiones.

Camel Case camelCase

El camelCase La función pone en mayúscula la primera letra de cada palabra de una cadena.

Sintaxis

{%= camelCase(string)%}

Ejemplo

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

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

Código Char en char-code-at

El charCodeAt devuelve el valor ASCII de un carácter, como la función charCodeAt de JavaScript. Toma una cadena y un entero (que define la posición del carácter) como argumentos de entrada y devuelve su valor ASCII correspondiente.

Sintaxis

{%= charCodeAt(string,int) %}: int

Ejemplo

La siguiente función devuelve el valor ASCII o, es decir 111.

{%= charCodeAt("some", 1)%}

Concat concate

El concat La función combina dos cadenas en una.

Sintaxis

{%= concat(string,string) %}

Ejemplo

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

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

Contains contains

El contains se utiliza para determinar si una cadena contiene una subcadena especificada.

Sintaxis

{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}
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.
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, devuelve "true"; de lo contrario, devuelve "false".

    code language-sql
    {%= 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".

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

No contiene doesNotContain

El doesNotContain se utiliza para determinar si una cadena no contiene una subcadena especificada.

Sintaxis

{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}
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.
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 por doesNotEndWith

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

Sintaxis

{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
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.
{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 entre mayúsculas y minúsculas, si la dirección de correo electrónico de la persona no termina con ".com".

doesNotEndWith(person.emailAddress,".com")

No empieza con doesNotStartWith

El doesNotStartWith se utiliza para determinar si una cadena no comienza con una subcadena especificada.

Sintaxis

{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
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.
{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 entre mayúsculas y minúsculas, si el nombre de la persona no comienza con "Joe".

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

Codificar 64 encode64

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

Sintaxis

{%= encode64(string) %}

Finaliza con endsWith

El endsWith se utiliza para determinar si una cadena termina con una subcadena especificada.

Sintaxis

{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
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.
{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 entre mayúsculas y minúsculas, si la dirección de correo electrónico de la persona termina con ".com".

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

Es igual a equals

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

Sintaxis

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

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

Ignorar mayúsculas y minúsculas equalsIgnoreCase

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

Sintaxis

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

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

Extraer dominio de correo electrónico extractEmailDomain

El extractEmailDomain para extraer el dominio de una dirección de correo electrónico.

Sintaxis

{%= 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) %}

Formato de moneda format-currency

El formatCurrency se utiliza para convertir cualquier número en su correspondiente representación de moneda sensible al idioma según la configuración regional pasada como cadena en el segundo argumento.

Sintaxis

{%= formatCurrency(number/double,string) %}: string

Ejemplo

Esta consulta devuelve 56 £

{%= formatCurrency(56L,"en_GB") %}

Obtener host de URL get-url-host

El getUrlHost se utiliza para recuperar el nombre de host de una dirección URL.

Sintaxis

{%= getUrlHost(string) %}: string

Ejemplo

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

Devuelve "www.myurl.com"

Obtener ruta de URL get-url-path

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

Sintaxis

{%= getUrlPath(string) %}: string

Ejemplo

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

Devuelve "/contact.html"

Obtener protocolo de URL get-url-protocol

El getUrlProtocol se utiliza para recuperar el protocolo de una dirección URL.

Sintaxis

{%= getUrlProtocol(string) %}: string

Ejemplo

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

Devuelve "http"

Índice De index-of

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

Sintaxis

{%= indexOf(STRING_1, STRING_2) %}: integer
Argumento
Descripción
{STRING_1}
Cadena en la que se realizará la comprobación.
{STRING_2}
La cadena que se busca en el primer parámetro

Ejemplo

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

Devuelve 6.

Is empty isEmpty

El isEmpty se utiliza para determinar si una cadena está vacía.

Sintaxis

{%= 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 is-not-empty

El isNotEmpty se utiliza para determinar si una cadena no está vacía.

Sintaxis

{= 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 last-index-of

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

Sintaxis

{= lastIndexOf(STRING_1, STRING_2) %}: integer
Argumento
Descripción
{STRING_1}
Cadena en la que se realizará la comprobación.
{STRING_2}
La cadena que se busca en el primer parámetro

Ejemplo

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

Devuelve 7.

Guarnecido izquierdo leftTrim

El leftTrim se utiliza para eliminar espacios en blanco del principio de una cadena.

Sintaxis

{%= leftTrim(string) %}

Length length

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

Sintaxis

{%= length(string) %}

Ejemplo

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

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

Like like

El like se utiliza para determinar si una cadena coincide con un patrón especificado.

Sintaxis

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

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

Minúsculas lower

El lowerCase convierte una cadena en letras minúsculas.

Sintaxis

{%= lowerCase(string) %}

Ejemplo

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

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

Devuelve como resultado matches

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.

Sintaxis

{%= matches(STRING_1, STRING_2) %}

Ejemplo

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

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

Máscara mask

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

Sintaxis

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

Ejemplo

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

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

La consulta devuelve 1XXXXXX89.

MD5 md5

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

Sintaxis

{%= md5(string) %}: string

Ejemplo

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

Devuelve "5eb63bbbe01eeed093cb22bb8f5acdc3"

No igual a notEqualTo

El notEqualTo se utiliza para determinar si una cadena no es igual a la cadena especificada.

Sintaxis

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

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

No Igual Con Ignorar Mayúsculas y Minúsculas not-equal-with-ignore-case

El notEqualWithIgnoreCase se utiliza para comparar dos cadenas ignorando mayúsculas y minúsculas.

Sintaxis

{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean
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 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 regexGroup

El Group se utiliza para extraer información específica, basada en la expresión regular proporcionada.

Sintaxis

{%= regexGroup(STRING, EXPRESSION, GROUP) %}
Argumento
Descripción
{STRING}
Cadena en la que se realizará la comprobación.
{EXPRESSION}
La expresión regular que debe coincidir con la primera cadena.
{GROUP}
Grupo de expresiones con el que debe 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 replace

El replace se utiliza para reemplazar una subcadena determinada de una cadena con otra subcadena.

Sintaxis

{%= replace(STRING_1,STRING_2,STRING_3) %}:string
Argumento
Descripción
{STRING_1}
Cadena en la que 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 "Hola Mark, aquí tienes tu newsletter mensual".

Reemplazar todo replaceAll

El replaceAll se utiliza para reemplazar todas las subcadenas de un texto que coincide con la expresión "regex" con la cadena "replace" literal especificada. Regex tiene un manejo especial de "" y "+" y todas las expresiones regex siguen la estrategia de escape PQL. La sustitución se realiza desde el principio de la cadena hasta el final, por ejemplo, si se sustituye "a" por "b" en la cadena "aaa", el resultado será "ba" en lugar de "ab".

Sintaxis

{%= replaceAll(string,string,string) %}
NOTE
Cuando la expresión tomada como segundo argumento es un carácter regex especial, utilice una doble barra invertida (//). Los caracteres regex especiales son: [., +, *, ?, ^, $, (, ), [,], {, }, |, .]
Obtenga más información en documentación del oracle.

Guarnecido derecho rightTrim

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

Sintaxis

{%= rightTrim(string) %}

División split

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

Sintaxis

{%= split(string,string) %}

Comienza con startsWith

El startsWith se utiliza para determinar si una cadena empieza con una subcadena especificada.

Sintaxis

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

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

Cadena a fecha string-to-date

El stringToDate convierte un valor de cadena en un valor de fecha y hora. Se necesitan dos argumentos: la representación de cadena de una fecha y hora y la representación de cadena del formateador.

Sintaxis

{= stringToDate("date-time value","formatter" %}

Ejemplo

{= stringToDate("2023-01-10 23:13:26", "yyyy-MM-dd HH:mm:ss") %}

Cadena a entero string-to-integer

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

Sintaxis

{= string_to_integer(string) %}: int

Cadena a número string-to-number

El stringToNumber se utiliza para convertir una cadena en número. Devuelve la misma cadena como salida para la entrada no válida.

Sintaxis

{%= stringToNumber(string) %}: double

Subcadena sub-string

El Count string se utiliza para devolver la subcadena de la expresión de cadena entre el índice inicial y el índice final.
Sintaxis

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

Caso de título titleCase

El titleCase se utiliza para poner en mayúscula las primeras letras de cada palabra de una cadena.

Sintaxis

{%= titleCase(string) %}

Ejemplo

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

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

A Bool to-bool

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

Sintaxis

{= toBool(string) %}: boolean

A Fecha Hora to-date-time

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

Sintaxis

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

A Fecha Hora Solamente to-date-time-only

El toDateTimeOnly se utiliza para convertir un valor de argumento en un valor de solo fecha y hora. Devuelve la fecha epoch como salida para una entrada no válida. Esta función acepta tipos de campo string, date, long e int.

Sintaxis

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

Recortar trim

El recortar elimina todos los espacios en blanco del principio y al final de una cadena.

Sintaxis

{%= trim(string) %}

Mayúsculas upper

El upperCase convierte una cadena en letras mayúsculas.

Sintaxis

{%= upperCase(string) %}

Ejemplo

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

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

Descodificación de URL url-decode

El urlDecode se utiliza para descodificar una cadena con codificación url.

Sintaxis

{%= urlDecode(string) %}: string

Codificación de URL url-encode

El Count only null se utiliza para codificar una cadena mediante url.

Sintaxis

{%= urlEncode(string) %}: string
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76