Funciones de Combinacion

Las funciones de combinacion permiten fusionar dos colecciones. La diferencia clave entre las dos funciones disponibles es como manejan los duplicados: union produce un conjunto (sin duplicados), mientras que combine preserva todos los elementos incluyendo duplicados.

union

Devuelve la union de conjuntos de la coleccion de entrada y otra coleccion. Los elementos duplicados se eliminan del resultado.

Firma:

union(other : Collection) : Collection

Parametros:

Tipo de Retorno: Collection

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "(1 | 2 | 3).union(3 | 4 | 5)")
// { 1, 2, 3, 4, 5 } (duplicates removed)

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

result, _ := fhirpath.Evaluate(resource, "(1 | 2).union(1 | 2)")
// { 1, 2 } (identical sets)

Casos Limite / Notas:

• El resultado es un conjunto sin elementos duplicados.
• La igualdad de elementos se determina por las reglas de igualdad de FHIRPath.
• El operador | en FHIRPath es equivalente a llamar a union. Por ejemplo, a | b es lo mismo que a.union(b).
• Si cualquiera de las colecciones esta vacia, el resultado es la otra coleccion (con duplicados eliminados).
• El orden de los elementos en el resultado depende de la implementacion.
• Utiliza el metodo Collection.Union internamente, que maneja la deduplicacion.

combine

Devuelve la concatenacion de la coleccion de entrada y otra coleccion. A diferencia de union, los duplicados se preservan.

Firma:

combine(other : Collection) : Collection

Parametros:

Tipo de Retorno: Collection

Ejemplos:

result, _ := fhirpath.Evaluate(resource, "(1 | 2 | 3).combine(3 | 4 | 5)")
// { 1, 2, 3, 3, 4, 5 } (duplicates preserved)

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

result, _ := fhirpath.Evaluate(patient, "Patient.name.first().given.combine(Patient.name.last().given)")
// Combines given names from first and last name entries

Casos Limite / Notas:

• A diferencia de union, combine no elimina duplicados. Es una concatenacion simple.
• El orden de los elementos se preserva: todos los elementos de la entrada vienen primero, seguidos por todos los elementos de la otra coleccion.
• Si cualquiera de las colecciones esta vacia, el resultado es la otra coleccion.
• Use combine cuando necesite preservar duplicados (por ejemplo, para contar o agregar). Use union cuando necesite semantica de conjuntos.

Comparacion: union vs. combine

Ejemplo que ilustra la diferencia:

// Given collections: {1, 2, 3} and {2, 3, 4}

// union removes duplicates
result, _ := fhirpath.Evaluate(resource, "(1 | 2 | 3).union(2 | 3 | 4)")
// { 1, 2, 3, 4 }

// combine preserves duplicates
result, _ := fhirpath.Evaluate(resource, "(1 | 2 | 3).combine(2 | 3 | 4)")
// { 1, 2, 3, 2, 3, 4 }