{{alias}}( obj[, options] ) Inverts an object, such that keys become values and values become keys. Beware when providing objects having values which are themselves objects. The function relies on native object serialization (`#toString`) when converting values to keys. Insertion order is not guaranteed, as object key enumeration is not specified according to the ECMAScript specification. In practice, however, most engines use insertion order to sort an object's keys, thus allowing for deterministic inversion. Parameters ---------- obj: ObjectLike Input object. options: Object (optional) Options. options.duplicates: boolean (optional) Boolean indicating whether to store keys mapped to duplicate values in arrays. Default: `true`. Returns ------- out: Object Inverted object. Examples -------- // Basic usage: > var obj = { 'a': 'beep', 'b': 'boop' }; > var out = {{alias}}( obj ) { 'beep': 'a', 'boop': 'b' } // Duplicate values: > obj = { 'a': 'beep', 'b': 'beep' }; > out = {{alias}}( obj ) { 'beep': [ 'a', 'b' ] } // Override duplicate values: > obj = {}; > obj.a = 'beep'; > obj.b = 'boop'; > obj.c = 'beep'; > out = {{alias}}( obj, { 'duplicates': false } ) { 'beep': 'c', 'boop': 'b' } See Also --------