Funciones de Cadena

Las funciones de cadena operan sobre valores String y proporcionan capacidades comunes de manipulacion de texto. Cuando se invocan sobre una coleccion vacia, todas las funciones de cadena devuelven una coleccion vacia. Si la entrada no es de tipo cadena, las funciones generalmente devuelven una coleccion vacia en lugar de generar un error.

startsWith

Devuelve true si la cadena de entrada comienza con el prefijo dado.

Firma:

startsWith(prefix : String) : Boolean

Parametros:

Tipo de Retorno: Boolean

Ejemplos:

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().family.startsWith('Smi')")
// For family = "Smith" -> true

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().family.startsWith('Jon')")
// For family = "Smith" -> false

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().family.startsWith('')")
// Any string starts with empty string -> true

Casos Limite / Notas:

• Devuelve una coleccion vacia si la entrada esta vacia.
• Un prefijo vacio ('') siempre devuelve true para cualquier cadena no vacia.
• La comparacion distingue entre mayusculas y minusculas.

endsWith

Devuelve true si la cadena de entrada termina con el sufijo dado.

Firma:

endsWith(suffix : String) : Boolean

Parametros:

Tipo de Retorno: Boolean

Ejemplos:

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().family.endsWith('ith')")
// For family = "Smith" -> true

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().family.endsWith('.pdf')")
// For family = "Smith" -> false

result, _ := fhirpath.Evaluate(resource, "Patient.id.endsWith('')")
// Any string ends with empty string -> true

Casos Limite / Notas:

• Devuelve una coleccion vacia si la entrada esta vacia.
• Un sufijo vacio ('') siempre devuelve true.
• La comparacion distingue entre mayusculas y minusculas.

contains

Devuelve true si la cadena de entrada contiene la subcadena dada.

Firma:

contains(substring : String) : Boolean

Parametros:

Tipo de Retorno: Boolean

Ejemplos:

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().family.contains('mit')")
// For family = "Smith" -> true

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().family.contains('xyz')")
// For family = "Smith" -> false

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().family.contains('')")
// Any string contains the empty string -> true

Casos Limite / Notas:

• Devuelve una coleccion vacia si la entrada esta vacia.
• Una subcadena vacia ('') siempre devuelve true.
• La busqueda distingue entre mayusculas y minusculas.

replace

Reemplaza todas las ocurrencias de una cadena patron con una cadena de sustitucion.

Firma:

replace(pattern : String, substitution : String) : String

Parametros:

Tipo de Retorno: String

Ejemplos:

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().family.replace('Smith', 'Jones')")
// "Smith" -> "Jones"

result, _ := fhirpath.Evaluate(resource, "'hello-world'.replace('-', '_')")
// "hello-world" -> "hello_world"

result, _ := fhirpath.Evaluate(resource, "'aaa'.replace('a', 'bb')")
// "aaa" -> "bbbbbb"

Casos Limite / Notas:

• Reemplaza todas las ocurrencias, no solo la primera.
• Este es un reemplazo de cadena literal, no un reemplazo de expresion regular. Use replaceMatches para expresiones regulares.
• Devuelve una coleccion vacia si la entrada esta vacia.

matches

Devuelve true si la cadena de entrada coincide con la expresion regular dada.

Firma:

matches(regex : String [, flags : String]) : Boolean

Parametros:

Tipo de Retorno: Boolean

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'ABC'.matches('[A-Z]{3}')")
// true

result, _ := fhirpath.Evaluate(resource, "'abc123'.matches('[a-z]+\\d+')")
// true

result, _ := fhirpath.Evaluate(resource, "'hello'.matches('^[0-9]+$')")
// false

result, _ := fhirpath.Evaluate(resource, "'ABC'.matches('abc', 'i')")
// true

La coincidencia es parcial. El patrón se busca en cualquier parte del valor; no se contrasta contra el valor completo. Es lo que pide la especificación —la frase “the start/end of line markers ^, $ can be used to match the entire string” solo tiene sentido si el patrón no está anclado de antemano— y es la fuente más común de sorpresa en esta función:

"'N8000123123'.matches('N[0-9]{8}')"      // true — contiene una secuencia de 8 dígitos
"'N8000123123'.matches('^N[0-9]{8}$')"    // false — anclado a mano
"'  X  '.matches('[A-Z][A-Za-z0-9_]*')"   // true — la X sola lo satisface

Use matchesFull cuando el patrón deba cubrir el valor completo, o ancle el patrón usted mismo con ^ y $.

Esto importa al leer las invariantes publicadas de FHIR, que en su mayoría no están ancladas: eld-19, eld-20 y la restricción [A-Z]([A-Za-z0-9_]){0,254} compartida por muchos recursos canónicos admiten un valor que solo contiene algo aceptable. Es una propiedad de esas restricciones y no de este motor: el validador Java de HL7 ancla porque String.matches de Java lo hace, no porque la especificación lo indique.

Casos Limite / Notas:

• Utiliza el paquete regexp de Go (RE2) para la coincidencia de patrones.
• La expresion regular se compila con cache y la coincidencia corre bajo un tiempo de espera.
• Devuelve una coleccion vacia si la entrada esta vacia.
• Un valor de flags que contenga algo distinto de i o m es un error, como exige la especificación.
• El . coincide con un salto de línea en todos los modos, que es el modo ‘single line’ que fija la especificación.

matchesFull

Devuelve true si la expresión regular coincide con la cadena de entrada completa.

Firma:

matchesFull(regex : String [, flags : String]) : Boolean

Parametros:

Tipo de Retorno: Boolean

La especificación la define como la forma en que los marcadores de inicio y fin siempre rodean el patrón, así que responde la pregunta que matches no responde: ¿tiene este valor, todo él, la forma que el patrón describe?

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'ABC'.matchesFull('[A-Z]{3}')")
// true

result, _ := fhirpath.Evaluate(resource, "'ABCD'.matchesFull('[A-Z]{3}')")
// false — con matches sería true

result, _ := fhirpath.Evaluate(resource, "'N8000123123'.matchesFull('N[0-9]{8}')")
// false — la cadena tiene 10 dígitos, no 8

result, _ := fhirpath.Evaluate(resource, "'N8000123123'.matchesFull('N[0-9]{10}')")
// true

Comparadas lado a lado, con la misma entrada y el mismo patrón:

Casos Limite / Notas:

• El anclaje usa \A y \z, que delimitan el texto completo sin importar los ^ o $ que haya dentro del patrón: un patrón ya anclado conserva su propio significado.
• Devuelve una coleccion vacia si la entrada o la expresion regular estan vacias.
• Definida en FHIRPath 3.0.0 y marcada como Standard for Trial Use.

replaceMatches

Reemplaza todas las ocurrencias de un patron de expresion regular con la cadena de sustitucion.

Firma:

replaceMatches(regex : String, substitution : String [, flags : String]) : String

Parametros:

Tipo de Retorno: String

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'hello   world'.replaceMatches('\\\\s+', ' ')")
// "hello   world" -> "hello world"

result, _ := fhirpath.Evaluate(resource, "'abc123def'.replaceMatches('[0-9]+', 'NUM')")
// "abc123def" -> "abcNUMdef"

result, _ := fhirpath.Evaluate(resource, "'2024-01-15'.replaceMatches('(\\\\d{4})-(\\\\d{2})-(\\\\d{2})', '$2/$3/$1')")
// "2024-01-15" -> "01/15/2024"

Casos Limite / Notas:

• Utiliza el paquete regexp de Go con compilacion en cache y proteccion contra tiempo de espera de ReDoS.
• La sustitucion soporta referencias hacia atras ($1, $2, etc.).
• Devuelve una coleccion vacia si la entrada esta vacia.

indexOf

Devuelve el indice basado en cero de la primera ocurrencia de la subcadena dada, o -1 si no se encuentra.

Firma:

indexOf(substring : String) : Integer

Parametros:

Tipo de Retorno: Integer

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'hello world'.indexOf('world')")
// 6

result, _ := fhirpath.Evaluate(resource, "'hello world'.indexOf('xyz')")
// -1

result, _ := fhirpath.Evaluate(resource, "'abcabc'.indexOf('bc')")
// 1 (first occurrence)

Casos Limite / Notas:

• Devuelve -1 cuando la subcadena no se encuentra.
• Devuelve 0 cuando se busca una cadena vacia.
• Devuelve una coleccion vacia si la entrada esta vacia.
• La busqueda distingue entre mayusculas y minusculas.

substring

Devuelve una subcadena comenzando en el indice basado en cero dado, opcionalmente limitada a una longitud especificada.

Firma:

substring(start : Integer [, length : Integer]) : String

Parametros:

Tipo de Retorno: String

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'hello world'.substring(6)")
// "world"

result, _ := fhirpath.Evaluate(resource, "'hello world'.substring(0, 5)")
// "hello"

result, _ := fhirpath.Evaluate(resource, "'abc'.substring(1, 10)")
// "bc" (length exceeds string, returns to end)

Casos Limite / Notas:

• Si start es negativo o mayor o igual a la longitud de la cadena, devuelve una coleccion vacia.
• Si length se extenderia mas alla del final de la cadena, devuelve los caracteres hasta el final.
• Devuelve una coleccion vacia si la entrada esta vacia.

lower

Devuelve la cadena de entrada convertida a minusculas.

Firma:

lower() : String

Tipo de Retorno: String

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'Hello World'.lower()")
// "hello world"

result, _ := fhirpath.Evaluate(resource, "'ABC123'.lower()")
// "abc123"

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().family.lower()")
// "Smith" -> "smith"

Casos Limite / Notas:

• Los caracteres no alfabeticos no se modifican.
• Devuelve una coleccion vacia si la entrada esta vacia.

upper

Devuelve la cadena de entrada convertida a mayusculas.

Firma:

upper() : String

Tipo de Retorno: String

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'Hello World'.upper()")
// "HELLO WORLD"

result, _ := fhirpath.Evaluate(resource, "'abc123'.upper()")
// "ABC123"

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().family.upper()")
// "Smith" -> "SMITH"

Casos Limite / Notas:

• Los caracteres no alfabeticos no se modifican.
• Devuelve una coleccion vacia si la entrada esta vacia.

length

Devuelve el numero de caracteres en la cadena de entrada.

Firma:

length() : Integer

Tipo de Retorno: Integer

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'hello'.length()")
// 5

result, _ := fhirpath.Evaluate(resource, "''.length()")
// 0

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().family.length()")
// "Smith" -> 5

Casos Limite / Notas:

• Devuelve la longitud en bytes de la cadena (len de Go), no el conteo de runas. Para cadenas ASCII, ambos son identicos.
• Devuelve una coleccion vacia si la entrada esta vacia.

toChars

Convierte una cadena en una coleccion de caracteres individuales, donde cada caracter es un elemento String separado.

Firma:

toChars() : Collection

Tipo de Retorno: Collection de String

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'abc'.toChars()")
// { "a", "b", "c" }

result, _ := fhirpath.Evaluate(resource, "'Hi'.toChars().count()")
// 2

result, _ := fhirpath.Evaluate(resource, "''.toChars()")
// { } (empty collection)

Casos Limite / Notas:

• Itera sobre runas Unicode, por lo que los caracteres multibyte se manejan correctamente.
• Una cadena vacia devuelve una coleccion vacia.
• Devuelve una coleccion vacia si la entrada esta vacia.

trim

Elimina los espacios en blanco iniciales y finales de la cadena de entrada.

Firma:

trim() : String

Tipo de Retorno: String

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'  hello  '.trim()")
// "hello"

result, _ := fhirpath.Evaluate(resource, "'\\thello\\n'.trim()")
// "hello"

result, _ := fhirpath.Evaluate(resource, "'nospace'.trim()")
// "nospace" (unchanged)

Casos Limite / Notas:

• Utiliza strings.TrimSpace de Go, que elimina todos los caracteres de espacio en blanco Unicode (espacios, tabulaciones, saltos de linea, etc.).
• No elimina los espacios en blanco del medio de la cadena.
• Devuelve una coleccion vacia si la entrada esta vacia.

split

Divide la cadena de entrada por el separador dado y devuelve una coleccion de subcadenas.

Firma:

split(separator : String) : Collection

Parametros:

Tipo de Retorno: Collection de String

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "'a,b,c'.split(',')")
// { "a", "b", "c" }

result, _ := fhirpath.Evaluate(resource, "'hello world'.split(' ')")
// { "hello", "world" }

result, _ := fhirpath.Evaluate(resource, "'no-delimiter'.split(',')")
// { "no-delimiter" } (single element)

Casos Limite / Notas:

• Si el separador no se encuentra, devuelve una coleccion con la cadena completa como un solo elemento.
• Un separador vacio divide en caracteres individuales (comportamiento de strings.Split de Go).
• Devuelve una coleccion vacia si la entrada esta vacia.

join

Une una coleccion de cadenas en una sola cadena, opcionalmente separada por un separador dado.

Firma:

join([separator : String]) : String

Parametros:

Tipo de Retorno: String

Ejemplos:

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().given.join(', ')")
// Given names "John", "James" -> "John, James"

result, _ := fhirpath.Evaluate(resource, "'a,b,c'.split(',').join('-')")
// "a-b-c"

result, _ := fhirpath.Evaluate(resource, "'a,b,c'.split(',').join()")
// "abc" (no separator)

Casos Limite / Notas:

• Si la coleccion de entrada esta vacia, devuelve una cadena vacia (""), no una coleccion vacia.
• Los elementos que no son cadenas en la coleccion se convierten a su representacion de cadena usando .String().
• Si no se proporciona argumento separador, los elementos se concatenan directamente.

encode / decode

Firma:

encode(encoding : String) : String
decode(encoding : String) : String

Descripcion:

• encode('base64') – Codifica la cadena de entrada a base64.
• decode('base64') – Decodifica una cadena codificada en base64.

Estas funciones estan planificadas para una version futura.