$map.extend

Description

Fusionne le contenu de deux maps ou plus. Le résultat de la fusion est repris dans le premier map.

Passage de paramètre par référence

Penser à utiliser le passage de paramètre par référence si l'intention est de mettre à jour l'objet de destination. Sinon la méthode ne modifiera pas l'objet mais en générera une copie. Les exemples reviennent sur cette notion.

Opérateurs & et &=

Les opérateurs & et &= permettent également de fusionner des maps.

Syntaxe

$map.extend( target [ , maps , ... ] )

Paramètres

target map

Map de destination

maps map...

Map(s) à fusionner avec target. Le paramètre peut figurer 0 ou n fois.

Retour

Retourne l'objet target (ou sa copie en cas de passage de paramètre par valeur) après fusion.

Exemple

var map = { a: 1, b: 2 };

// exemple avec passage de paramètre par valeur (ne modifie pas l'objet map)
$map.extend(map, { c: 3 });
$logger.info(map);          // affiche {"a": 1, "b": 2} 

// exemple avec passage de paramètre par référence (modifie l'objet map)
$map.extend(&map, { c: 3 });
$logger.info(map);          // affiche {"a": 1, "b": 2, "c": 3}