Funciones de cadena string-functions

concat(<string>,<string>)

concat(<listString>)

Devuelve una cadena.

concat("Hello","World")

Devuelve “HelloWorld”.

concat(["Hello"," ","World"])

Devuelve “Hello World”.

• cadena

contain(<string>,<string>)

Devuelve un valor booleano.

contain("rowing is great", "great")

Devuelve verdadero.

containIgnoreCase(<string>,<string>)

Devuelve un valor booleano.

containIgnoreCase("rowing is great", "GREAT")

Devuelve verdadero.

endWith(<string>,<string>)

Devuelve un valor booleano.

endWith("Hello World", "World")

Devuelve verdadero.

endWith("Hello World", "Hello")

Devuelve falso.

endWithIgnoreCase(<string>,<string>)

Devuelve un valor booleano.

endWithIgnoreCase("rowing is great", "AT")

Devuelve verdadero.

• cadena

equalIgnoreCase(<string>,<string>)

Devuelve un valor booleano.

equalIgnoreCase("rowing is great", "rowing is GREAT")

Devuelve verdadero.

indexOf(<string>,<string>)

Devuelve un entero.

indexOf("Hello", "l")

Devuelve 2.

Explicación:

En “Hello”, la primera aparición de “l” es en la posición 2.

• cadena

isEmpty(<string>)

Devuelve un valor booleano.

isEmpty("")

Devuelve verdadero.

isEmpty("Hello World")

Devuelve falso.

isEmpty(<null>)

Devuelve falso.

• cadena

isNotEmpty(<string>)

Devuelve un valor booleano.

isNotEmpty("")

Devuelve falso.

isNotEmpty("hello")

Devuelve verdadero.

lastIndexOf(<string>,<string>)

Devuelve un entero.

lastIndexOf("Hello", "l")

Devuelve 3.

Explicación:

En “Hello”, la última ocurrencia de “l” está en la posición 3.

• cadena

length(<string>)

Devuelve un entero.

length("Hello World")

Devuelve 11.

• cadena

lower(<string>)

Devuelve una cadena.

lower("A")

Devuelve “a”.

matchRegExp(<string>,<string>)

Devuelve un valor booleano.

matchRegExp("12345", "\\d+")

Devuelve verdadero.

• cadena

notEqualIgnoreCase(<string>,<string>)

Devuelve un valor booleano.

replace(<base>,<target>,<replacement>)

Devolver una cadena.

replace("Hello World", "l", "x")

Devuelve “Mundo Hexlo”.

Ejemplo con RegExp:

Dado que el parámetro de destino es RegExp, en función de la cadena que desee reemplazar, es posible que tenga que omitir algunos caracteres. Vea el siguiente ejemplo:

• cadena que evaluar: |OFFER_A|OFFER_B
• proporcionado por un atributo de perfil #{ExperiencePlatform.myFieldGroup.profile.myOffers}
• Cadena que reemplazar: |OFFER_A
• Cadena reemplazada por: ''
• Debe agregar \\ antes del carácter |.

La expresión es:

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|OFFER_A', '')

La cadena devuelta es: |OFFER_B

También puede generar la cadena que desea reemplazar desde un atributo determinado:

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|' + #{ExperiencePlatform.myFieldGroup.profile.myOfferCode}, '')

replaceAll(<baseString>,<sourceString>,<replacementString>)

Devuelve una cadena.

replaceAll("Hello World", "l", "x")

Devuelve “Hexxo Worxd”.

Dado que el parámetro de destino es RegExp, en función de la cadena que desee reemplazar, es posible que tenga que omitir algunos caracteres. Consulte el ejemplo en la función replace.

split(<input string>, <separator string>)

Devuelve un valor listString.

split("A_B_C", "_")

Devuelve ["A","B","C"]

Ejemplo con un campo de evento “event.appVersion” con el valor: “20.45.2.3434”

split(@event{event.appVersion}, "\\.")

Devuelve ["20", "45", "2", "3434"]

startWith(<string>,<string>)

Devuelve un valor booleano.

startWith("Hello World", "Hello")

Devuelve verdadero.

startWith("Hello World", "World")

Devuelve falso.

startWithIgnoreCase(<string>,<string>)

Devuelve un valor booleano.

startWithIgnoreCase("rowing is great", "RO")

Devuelve verdadero.

substr(<string>,<beginIndex>)

substr(<string>,<beginIndex>,<endIndex>)

Devolver una cadena.

substr("Hello World",6)

Devuelve “World”.

substr("Hello World", 0, 5)

Devuelve “Hello”.

trim(<string>)

Devolver una cadena.

trim(" Hello ")

Devuelve “Hello”.

upper(<string>)

Devolver una cadena.

upper("b")

Devuelve “B”.

uuid()

Devuelve una cadena.

uuid()

Devuelve “79e70b7f-8a85-400b-97a1-9f9826121553”.

Esta sección contiene conocimientos estructurados destinados a apoyar la interpretación, la recuperación y la respuesta a preguntas relacionadas con este tema.

Para una comprensión completa, esta información debe combinarse con la documentación de esta página. Ninguna de las fuentes pretende ser independiente; la página describe la función, mientras que esta sección proporciona contexto adicional que ayuda a desambiguar la terminología, la intención, la aplicabilidad y las restricciones.

• TL;DR: Esta página documenta todas las funciones de cadena disponibles en las expresiones de recorrido de AJO, que abarcan la búsqueda de texto, la comparación, la transformación, la extracción, la validación, el reemplazo, la división y la generación de identificadores únicos.

Intenciones:

• Concatenar dos o más cadenas utilizando concat
• Busque una subcadena dentro de una cadena (con distinción entre mayúsculas y minúsculas o sin distinción entre mayúsculas y minúsculas) usando contain o containIgnoreCase
• Comparar dos cadenas mientras se omiten las mayúsculas y minúsculas usando equalIgnoreCase o notEqualIgnoreCase
• Compruebe si una cadena comienza o termina con un prefijo o sufijo específico utilizando startWith, endWith y sus variantes que no distinguen entre mayúsculas y minúsculas
• Extraer una subcadena por posiciones de índice utilizando substr
• Reemplazar la primera o todas las ocurrencias de un patrón en una cadena usando replace o replaceAll
• Dividir una cadena en una lista de tokens mediante un separador con split
• Genere un UUID aleatorio para las necesidades de identificador único usando uuid
• Compruebe si una cadena está vacía o no está vacía usando isEmpty o isNotEmpty

Glosario:

• RegExp: un patrón de expresión regular utilizado como parámetro de destino en replace, replaceAll y matchRegExp; los caracteres especiales deben tener un carácter de escape de \\
• UUID: identificador único universal: identificador de cadena generado aleatoriamente devuelto por uuid()
• substr: extrae una parte de una cadena especificando un índice inicial y un índice final opcional (basado en cero)

Protecciones:

• El parámetro target en replace y replaceAll se trata como RegExp; los caracteres especiales (por ejemplo, |, .) deben tener un carácter de escape con \\
• replace reemplaza solamente la primera incidencia que coincida; use replaceAll para reemplazar todas las incidencias
• isEmpty devuelve falso para valores nulos (no verdadero); nulo no se considera una cadena vacía
• indexOf y lastIndexOf devuelven -1 cuando no se encuentra ninguna coincidencia
• Las posiciones de índice de la cadena están basadas en cero (el primer carácter se encuentra en la posición 0)

Terminología:

• Nombre canónico: Funciones de cadena — Acrónimo: none — variantes: funciones de texto, funciones de manipulación de cadenas
• Sinónimos: “contain” = “substring check”; “split” = “tokenize string”; “trim” = “strip whitespace”
• No confunda: “replace” (solo primera incidencia) ≠ “replaceAll” (todas las incidencias)
• No confunda: “indexOf” (posición de la primera incidencia) ≠ “lastIndexOf” (posición de la última incidencia)
• No confunda: “isEmpty” (verdadero solo para la cadena de longitud cero) ≠ comprobación nula (isEmpty devuelve falso para nulo)
• No confunda: “equalIgnoreCase” (devuelve true cuando el caso de omisión es igual) ≠ “notEqualIgnoreCase” (devuelve true cuando el caso de omisión es diferente)

PREGUNTAS MÁS FRECUENTES:

• Q: ¿Cómo puedo comprobar si una cadena contiene una subcadena independientemente de las mayúsculas y minúsculas? — Use containIgnoreCase("myString", "searchTerm"), que devuelve true si el término de búsqueda se encuentra en cualquier caso.
• Q: ¿Cuál es la diferencia entre replace y replaceAll? — replace sustituye solamente la primera aparición que coincida; replaceAll sustituye todas las apariciones de la cadena.
• Q: ¿Por qué necesito omitir el carácter | en replace? — El parámetro de destino se trata como una expresión regular; | es un carácter RegExp especial y debe omitirse como \\| para tratarse como una barra vertical literal.
• Q: ¿Devuelve isEmpty true para null? — No, isEmpty devuelve false para null; solo devuelve true para una cadena de longitud cero "".
• Q: ¿Cómo extraigo el número de versión principal de una cadena de versión como “20.45.2.3434”? — Utilice getListItem(split(@event{event.appVersion}, "\\."), 0) para dividir por puntos y recuperar el primer elemento.
• Q: ¿Cómo se genera un identificador único en una expresión de recorrido? — Use uuid(), que devuelve una cadena UUID generada aleatoriamente sin parámetros requeridos.