`$map.remove`¶

Description¶

Retire un élément dans le map

Syntaxe¶

$map.remove( map , keys )

Paramètres¶

map map: Map à traiter
keys string / array: Nom du membre à supprimer. Peut désigner un tableau, auquel cas chaque clé référencée dans le tableau sera retirée du map.

Retour¶

Retourne le map résultant du retrait des entrées indiquées

Exemple¶

var map = { a: 1, b: 2 };
$logger.info(map);

$logger.info("exemples de get");
$logger.info($map.remove(map, "b"));    // affiche {"a": 1}, mais ne modifie pas "map"
$logger.info(map);                      // {"a": 1, "b": 2}

$logger.info($map.remove(&map, "b"));   // affiche {"a": 1} et modifie pas "map"
$logger.info(map);                      // {"a": 1}

$logger.info($map.remove(map, "b"));    // affiche {"a": 1}

Modification d'API

De base les méthodes fournies par Ewt sont "immutables". Cela signifie qu'il n'est pas possible de les modifier. Ainsi, l'instruction suivante provoquera une erreur:

$logger.info = function(x) { $logger.warn(x); };

Cette instruction cherche à redéfinir le fonctionnement de la méthode $logger.info, ce qui n'est pas permis de base.

Cependant, la méthode $map.remove permet malgré tout de supprimer une méthode fournie par Ewt. Ainsi l'instruction suivante permettra de supprimer la méthode $logger.info:

$map.remove(&$logger, "info");
$logger.info("test");       // provoque une erreur car la méthode
                            // n'existe plus (pour le traitement
                            // en cours

L'opération est permise dans la version actuelle du moteur, mais il n'est pas exclu que cela soit retiré dans les versions futures.

$map.remove¶