$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.

Notez que les noms de variable pour target et source sont passés directement sans les 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"