attach

각 값을 그 값에서 유도한 결과와 짝지습니다. 입력이 결과 곁에 남습니다.

Iterable<(A, B)> fxAttach<A, B>(B Function(A a) f, Iterable<A> iterable) FxAsyncIterable<(A, B)> fxAttachAsync<A, B>(FutureOr<B> Function(A a) f, FxAsyncIterable<A> iterable) Fx<(T, R)> Fx<T>.attach<R>(R Function(T a) f) // chain (sync) FxAsync<(T, R)> FxAsync<T>.attach<R>(FutureOr<R> Function(T a) f) // chain (async)

강의

map은 각 값을 결과로 바꿉니다. 그런데 하류에서 다시 입력이 필요해지면(대체 값으로 쓰거나, 라벨을 붙이거나, 로그를 남기려고) 결국 레코드를 손으로 조립하게 됩니다: .map((x) async => (x, await f(x))). attach(f)는 이 관용구를 연산자로 만든 것입니다. (value, f(value)) 쌍을 지연 평가로 하나씩 내놓습니다.

비동기 체인에서 쓸모가 특히 큽니다. 품목마다 가격을 조회하면 쌍이 품목을 (없을 수도 있는) 가격 옆에 그대로 붙잡아 두므로, 대체 값 r.$2 ?? r.$1.listPrice도, "이게 어느 SKU였지?"라는 라벨도 여전히 쓸 수 있습니다. 비동기 형태는 fxMapAsync 위에 만들어져 병렬에 안전합니다. 뒤에 concurrent(n)을 붙이면 조회가 n개씩 동시에 실행됩니다.

Dart 고유의 추가 기능입니다(FxTS에는 대응물이 없습니다). 유도한 값만 필요하면 계속 map을 쓰고, 입력을 키로 삼은 조회 테이블이 필요하다면 indexBy를 쓰세요.

데모 1 · map을 거쳐도 입력이 남습니다

데모 2 · 대체 값이 있는 비동기 조회

직접 해 보기

연습: 각 검색어를 그 검색 결과 곁에 붙잡아 두세요.

관련 항목: map — 입력이 필요 없을 때 · zip — 별개의 두 시퀀스 짝짓기 · concurrent — attach 뒤에서 비동기 팬아웃 제한하기