fxMapAccum

Una acumulación progresiva, un valor de salida por cada valor de entrada: scan sin la semilla.

Iterable<B> fxMapAccum<A, B>(B Function(B acc, A a) f, B seed, Iterable<A> iterable) FxAsyncIterable<B> fxMapAccumAsync<A, B>(FutureOr<B> Function(B acc, A a) f, FutureOr<B> seed, FxAsyncIterable<A> iterable) Fx<B> Fx<T>.mapAccum<B>(B Function(B acc, T a) f, B seed) // chain (sync) FxAsync<B> FxAsync<T>.mapAccum<B>(FutureOr<B> Function(B acc, T a) f, FutureOr<B> seed) // chain (async)

Lección

scan emite primero su semilla, así que n valores de entrada dan n + 1 de salida. Eso es correcto cuando el estado inicial forma parte de la respuesta —el saldo de apertura de un libro de cuentas— e incorrecto cuando solo es el estado en el que se pliega el primer elemento, y por eso tantas llamadas a scan acaban con un .drop(1) al final. fxMapAccum(f, seed, xs) es esa forma como un único operador: pliega cada valor sobre seed con f y emite cada acumulación intermedia, pero nunca la semilla misma. n de entrada, n de salida: una entrada vacía no emite nada en absoluto.

El orden de los argumentos coincide con el de fxScan a propósito, así que pasar de uno a otro es cambiar una palabra. Es perezoso, f se ejecuta exactamente una vez por cada elemento del que se tira, en orden, y el acumulador pertenece a la iteración: iterar dos veces empieza desde seed ambas veces. El tipo del acumulador B no tiene por qué coincidir con el del elemento: pliega cadenas en una ruta, números en un registro.

fxMapAccumAsync admite que tanto f como seed sean un Future. El pliegue se serializa —cada paso necesita el anterior—, pero una etapa aguas arriba puede seguir ejecutándose con concurrent(n), como en la Demo 2. En la cadena es fx(xs).mapAccum(f, seed). Extensión de fxdart (no forma parte de FxTS): el Iterator::scan de Rust, el mapAccumL de Haskell y el scan de RxDart emiten los mismos n valores.

Demo 1 · scan, menos la semilla

Demo 2 · Asíncrono, con concurrencia aguas arriba

Pruébalo tú

Ejercicio: elimina el drop(1) del final.

Relacionado: scan — el mismo pliegue, con la semilla · reduce/fold — solo el valor final · drop — lo que mapAccum te ahorra · concurrent — evaluación en paralelo aguas arriba