SwitchIfEmptyStreamTransformer<S> class

When the original stream emits no items, this operator subscribes to the given fallback stream and emits items from that stream instead.

This can be particularly useful when consuming data from multiple sources. For example, when using the Repository Pattern. Assuming you have some data you need to load, you might want to start with the fastest access point and keep falling back to the slowest point. For example, first query an in-memory database, then a database on the file system, then a network call if the data isn't on the local machine.

This can be achieved quite simply with switchIfEmpty!


// Let's pretend we have some Data sources that complete without emitting
// any items if they don't contain the data we're looking for
Stream<Data> memory;
Stream<Data> disk;
Stream<Data> network;

// Start with memory, fallback to disk, then fallback to network.
// Simple as that!
Stream<Data> getThatData =


SwitchIfEmptyStreamTransformer(Stream<S> fallbackStream)
Constructs a StreamTransformer which, when the source Stream emits no events, switches over to fallbackStream.


fallbackStream Stream<S>
The Stream which will be used as fallback, if the source Stream is empty.
hashCode int
The hash code for this object. [...]
read-only, inherited
runtimeType Type
A representation of the runtime type of the object.
read-only, inherited


bind(Stream<S> stream) Stream<S>
Transforms the provided stream. [...]
cast<RS, RT>() StreamTransformer<RS, RT>
Provides a StreamTransformer<RS, RT> view of this stream transformer. [...]
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed. [...]
toString() String
A string representation of this object. [...]


operator ==(Object other) bool
The equality operator. [...]