mapNotNull · firstNotNullOf

Transforma y filtra en un solo paso: el callback devuelve el nuevo valor, o null para saltarlo.

Iterable<B> mapNotNull<A, B extends Object>(B? Function(A a) f, Iterable<A> iterable) FxAsyncIterable<B> mapNotNullAsync<A, B extends Object>(FutureOr<B?> Function(A a) f, FxAsyncIterable<A> iterable) B? firstNotNullOf<A, B extends Object>(B? Function(A a) f, Iterable<A> iterable) Future<B?> firstNotNullOfAsync<A, B extends Object>(FutureOr<B?> Function(A a) f, FxAsyncIterable<A> iterable) Fx<R> Fx<T>.mapNotNull<R extends Object>(R? Function(T a) f) // chain (sync) R? Fx<T>.firstNotNullOf<R extends Object>(R? Function(T a) f) // chain (sync) FxAsync<R> FxAsync<T>.mapNotNull<R extends Object>(FutureOr<R?> Function(T a) f) // chain (async) Future<R?> FxAsync<T>.firstNotNullOf<R extends Object>(FutureOr<R?> Function(T a) f) // chain (async)

Lección

Mucho mapeo es parcial: parsear una cadena que quizá no sea un número, buscar una clave que quizá falte. La versión larga es un where que ejecuta el trabajo para comprobarlo y un map que lo ejecuta otra vez para quedárselo, o bien fxCompact(fxMap(f, xs)), que apila dos etapas perezosas. mapNotNull(f, xs) hace ambas cosas en una sola etapa: f devuelve el nuevo valor, y un resultado null significa salta este elemento. f se ejecuta una vez por elemento, y solo cuando se tira de ese elemento.

El tipo de resultado B está acotado a Object, así que mapNotNull(int.tryParse, xs) es un Iterable<int>, no int?: un null nunca puede significar emite null. firstNotNullOf(f, xs) es la misma idea como operación terminal: devuelve el primer resultado no nulo de f y se detiene ahí, o null cuando todos los resultados son null (o la entrada está vacía). Mientras que find devuelve el elemento que coincidió, firstNotNullOf devuelve la proyección, sin una segunda llamada para obtenerla.

Las variantes asíncronas son mapNotNullAsync y firstNotNullOfAsync; f puede devolver un Future. mapNotNullAsync está construido sobre fxMapAsync, que es seguro en paralelo, así que concurrent(n) ejecuta n callbacks a la vez; firstNotNullOfAsync tira de un elemento cada vez y cancela la fuente en el primer acierto. En la cadena son fx(xs).mapNotNull(f) y fx(xs).firstNotNullOf(f). Adición nativa de Dart (no forma parte de FxTS): el mapNotNull y el firstNotNullOfOrNull de Kotlin, el filter_map de Rust.

Demo 1 · Parsear lo que se puede parsear

Demo 2 · Búsquedas asíncronas que pueden fallar

Pruébalo tú

Ejercicio: deja de parsear cada respuesta dos veces.

Relacionado: map — cuando todo elemento tiene un resultado · where — conserva elementos, sin cambiarlos · nonNulls — descarta los null que ya están ahí · find — el primer elemento que coincide, no su proyección