fxMapValues & friends

Transforma cada valor, cada clave o la entrada (clave, valor) completa de un 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)

Lección

El resto de la sección 9 selecciona de un map — fxPick, fxOmit, fxPickBy, fxOmitBy — o lee una parte de él. Estos tres lo transforman. fxMapValues pasa cada valor por un callback y deja las claves en paz, fxMapKeys hace lo contrario, y fxMapEntries toma el record (clave, valor) entero y devuelve uno nuevo.

Ese record tiene la misma forma que ya usan fxPickBy, fxOmitBy y fxFromEntries, así que los cuatro componen sin adaptadores: filtras con uno y transformas con el otro. fxMapEntries generaliza a los otros dos: intercambiar e.$1 y e.$2 invierte un map en una sola llamada.

fxMapValues no puede perder ninguna entrada, porque las claves quedan intactas. fxMapKeys y fxMapEntries sí pueden: si el callback lleva dos claves al mismo resultado, gana la última en orden de iteración, exactamente como haría una clave repetida en un literal de map. Por lo demás el orden de inserción sobrevive, siguiendo la primera aparición de cada clave nueva.

Aquí no hay filter ni filterWithKey, y es deliberado. fxPickBy y fxOmitBy ya toman el record completo, así que ignorar una mitad es la forma de filtrar por la otra; míralo en la segunda demo.

Compara con fxEvolve, aquí al lado: transforma los valores de claves concretas y deja pasar el resto. fxMapValues es el caso en que todos los valores reciben el mismo trato.

Demo 1 · Fundamentos

Demo 2 · Colisiones, y filtrar al lado

Pruébalo tú

Ejercicio: convierte cada puntuación en una nota con letra, conservando los nombres.

Relacionado: fxEvolve — transforma solo los valores de las claves indicadas · fxPickBy / fxOmitBy — los filtros que conocen la clave, con el mismo record · fxFromEntries — construye un map a partir de records · fxCompactObject — quita los valores null