$copymerge

Gebruik: $copymerge(doel,bron[,keep_duplicates])

Categorie: toewijzing

Geïmplementeerd: Picard 1.0

Beschrijving:

Voegt metadata van de variabele bron samen met de metadata van de variabele doel. Dubbelen worden verwijderd en de metadata van de bron worden achter de metadata van het doel toegevoegd, zodat de oorspronkelijke volgorde behouden blijft. Net als bij $copy worden meervoudige variabelen gekopieerd zonder ze enkelvoudig te maken. De uiteindelijke variabele doel zal meervoudig zijn.

Als keep_duplicates is ingesteld, worden dubbelen niet uit het resultaat verwijderd.

Notitie

In tegenstelling tot de meeste functies wordt source opgegeven zonder procenttekens (%).

Voorbeeld:

De volgende instructies leveren de aangegeven waarden voor doel op:

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