このページはまだ翻訳されていないため、英語で表示されます。 翻訳に参加する

fxMapValues & friends

Transforms every value, every key, or the whole (key, value) entry of a map.

Map<K, T> fxMapValues<K, V, T>(T Function(V value) f, Map<K, V> map) Map<T, V> fxMapKeys<K, V, T>(T Function(K key) f, Map<K, V> map) Map<K2, V2> fxMapEntries<K, V, K2, V2>((K2, V2) Function((K, V) entry) f, Map<K, V> map)

Lecture

The rest of section 9 selects from a map — fxPick, fxOmit, fxPickBy, fxOmitBy — or reads one part of it. These three transform it. fxMapValues runs every value through a callback and leaves the keys alone, fxMapKeys does the reverse, and fxMapEntries takes the whole (key, value) record and gives back a new one.

That record is the same shape fxPickBy, fxOmitBy and fxFromEntries already use, so the four compose without any adapting: filter with one, transform with the other. fxMapEntries generalises the other two — swapping e.$1 and e.$2 inverts a map in one call.

fxMapValues can never lose an entry, because the keys are untouched. fxMapKeys and fxMapEntries can: if the callback maps two keys onto the same result, the last one in iteration order wins, exactly as a repeated key in a map literal would. Insertion order otherwise survives, following the first appearance of each new key.

There is deliberately no filter or filterWithKey here. fxPickBy and fxOmitBy already take the whole record, so ignoring one half is how you filter by the other — see the second demo.

Compare fxEvolve, next door: it transforms the values of named keys and passes the rest through. fxMapValues is the case where every value gets the same treatment.

Demo 1 · Basics

Demo 2 · Collisions, and filtering alongside

Try it yourself

Exercise: turn every score into a letter grade, keeping the names.

Related: fxEvolve — transform the values of named keys only · fxPickBy / fxOmitBy — the key-aware filters, same record shape · fxFromEntries — build a map from records · fxCompactObject — drop the null values