fxPipe1

Aplica una función a un valor, esperándolo antes si el valor es un Future.

FutureOr<R> fxPipe1<A, R>(FutureOr<A> a, FutureOr<R> Function(A a) f)

Lección

fxPipe1 es la forma de un solo paso de pipe: aplica f a a, pero si a es un Future, lo espera primero. Si a es un valor normal, f se ejecuta al momento y fxPipe1 devuelve lo que devuelva f — de forma síncrona, sin ninguna envoltura Future.

La gracia es que f nunca tiene que saber ni preocuparse de si el valor que recibe viene de trabajo síncrono o asíncrono aguas arriba: fxPipe1 lo normaliza por ti. Resulta muy cómodo cuando estás componiendo un valor que a veces es un Future (por ejemplo, el resultado de un paso asíncrono anterior) y quieres que el siguiente paso se escriba igual en ambos casos.

Como solo maneja un paso, puedes anidar llamadas a fxPipe1 para componer una cadena corta, o recurrir al pipe completo (una List<Function>) cuando hay más de uno o dos pasos.

Demo 1 · Un valor normal (sin Future)

Sin ningún Future de por medio, fxPipe1 simplemente llama a f(a) directamente y devuelve un valor normal:

Demo 2 · Esperar antes a un Future

Cuando a es un Future, fxPipe1 lo espera antes de llamar a f — encadena unos cuantos para componer pasos asíncronos de uno en uno:

Pruébalo tú

Ejercicio: usa fxPipe1 para convertir un nombre diferido en un saludo.

Relacionado: pipe — pipeline de varios pasos, la misma idea para una lista de pasos · fx — la alternativa tipada en forma de cadena · fxDelay & fxSleep — las utilidades asíncronas usadas arriba