$copymerge

Utilisation: $copymerge(target,source[,keep_duplicates])
Catégorie: affectation
Mis en œuvre: Picard 1.0

Description:

Fusionne les métadonnées de la variable source dans target, en supprimant les doublons et en les ajoutant à la fin, conservant ainsi l’ordre d’origine. Comme $copy, cela copiera également les variables à valeurs multiples sans les aplatir. Après l’opération, target sera une variable à valeurs multiples.

Si keep_duplicates est défini, alors les doublons ne seront pas supprimés du résultat.

Note

Contrairement à la plupart des fonctions, dans ce cas, la source est spécifiée sans l’entourer de signes de pourcentage (%).

Exemple:

Les instructions suivantes donneront les valeurs de target comme indiqué:

$set(target,)
$set(source,one)
$copymerge(target,source)     ==>  "one"

$set(target,zero)
$set(source,one)
$copymerge(target,source)     ==>  "zero; one"

$set(target,zero)
$setmulti(source,one; two)
$copymerge(target,source)     ==>  "zero; one; two"

$setmulti(target,zero; two)
$setmulti(source,one; two)
$copymerge(target,source)     ==>  "zero; two; one"

$set(target,zero; one; zero)
$set(source,one; two; three)
$copymerge(target,source)     ==>  "zero, one; two; three"

$setmulti(target,zero; two)
$setmulti(source,one; two)
$copymerge(target,source,1)   ==>  "zero; two; one; two"