Key Value Pairs

Motivation

There are three very similar ways to represent maps between keys and values, each of which have a specific purpose:

To make it easy to translate between these purposes and representations, there is a uniform set of methods:

Examples

Mapping Parameters

The method asDict optionally takes a mergeFunc and a class argument. // IdentityDictionary[ (a -> 1), (c -> 3), (b -> 2) ] [\a, 1, \a, 3, \b, 2, \c, 3, \c, 7].asDict; // IdentityDictionary[ (a -> 4), (c -> 10), (b -> 2) ] [\a, 1, \a, 3, \b, 2, \c, 3, \c, 7].asDict({ |new, old| new + old }) // Dictionary[ (what -> was), (how -> wie), (and -> und), (this -> das) ] ["this", "das", "and", "und", "what", "was", "how", "wie"].asDict(class: Dictionary) // Environment[ (a -> 1), (b -> 2) ] [\a, 1, \b, 2].asDict(class: Environment)

The method asEvent is a shortcut:[\freq, 100, \amp, 0.1].asEvent // ( 'amp': 0.1, 'freq': 100 )

The methods asAssociations and asPairs optionally take a class argument.// SortedList[ (a -> 1871), (b -> 1848), (c -> 1789) ] (c:1789, b:1848, a:1871).asAssociations(SortedList); // LinkedList[ a, 1871, c, 1789, b, 1848 ] (c:1789, b:1848, a:1871).asPairs(LinkedList);