mapNotNull · firstNotNullOf

변환과 필터링을 한 번에 — 콜백이 새 값을 반환하거나, 건너뛰려면 null을 반환합니다.

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)

강의

매핑 중 상당수는 부분적입니다. 숫자가 아닐 수도 있는 문자열을 파싱하거나, 없을 수도 있는 키를 조회하는 경우죠. 이를 길게 풀어 쓰면 작업을 한 번 실행해 검사하는 where와 그 작업을 다시 실행해 값을 남기는 map이 되거나, 지연 단계 두 개를 쌓는 fxCompact(fxMap(f, xs))가 됩니다. mapNotNull(f, xs)는 이 둘을 한 단계에서 처리합니다. f가 새 값을 반환하고, 결과가 null이면 이 원소를 건너뛴다는 뜻입니다. f는 원소마다 한 번, 그 원소를 꺼낼 때에만 실행됩니다.

결과 타입 B는 Object로 한정되므로 mapNotNull(int.tryParse, xs)는 int?가 아니라 Iterable<int>입니다 — null이 null을 내보낸다는 뜻이 될 일은 없습니다. firstNotNullOf(f, xs)는 같은 아이디어의 종결 연산입니다. f의 첫 번째 non-null 결과를 반환하고 거기서 멈추며, 모든 결과가 null이면(또는 입력이 비어 있으면) null을 반환합니다. find는 일치한 원소를 반환하지만, firstNotNullOf는 투영한 값을 반환합니다 — 그 값을 얻으려고 다시 호출할 필요가 없습니다.

비동기 짝은 mapNotNullAsync와 firstNotNullOfAsync이며, f는 Future를 반환해도 됩니다. mapNotNullAsync는 병렬에 안전한 fxMapAsync 위에 만들어져 있어서 concurrent(n)을 붙이면 콜백이 n개씩 동시에 실행됩니다. firstNotNullOfAsync는 원소를 하나씩 꺼내고 첫 결과에서 소스를 취소합니다. 체인에서는 fx(xs).mapNotNull(f)와 fx(xs).firstNotNullOf(f)입니다. Dart 고유의 추가 기능입니다(FxTS에는 없습니다) — Kotlin의 mapNotNull과 firstNotNullOfOrNull, Rust의 filter_map에 해당합니다.

데모 1 · 파싱되는 것만 파싱

데모 2 · 빗나갈 수 있는 비동기 조회

직접 해 보기

연습: 모든 답을 두 번씩 파싱하는 일을 멈추세요.

관련 항목: map — 모든 원소에 결과가 있을 때 · where — 원소를 바꾸지 않고 남길 때 · nonNulls — 이미 들어 있는 null을 버릴 때 · find — 투영이 아니라 첫 번째로 일치한 원소