1. StreamTransformer<T,S>streamTransformer

AppliesstreamTransformer to this stream.

Returns the transformed stream,that is, the result ofstreamTransformer.bind(this).This method simply allows writing the call tostreamTransformer.bindin a chained fashion, like

stream.map(mapping).transform(transformation).toList()

which can be more convenient than callingbind directly.

ThestreamTransformer can return any stream.Whether the returned stream is a broadcast stream or not,and which elements it will contain,is entirely up to the transformation.

This method should always be used for transformations which treatthe entire stream as representing a single valuewhich has perhaps been split into several parts for transport,like a file being read from disk or being fetched over a network.The transformation will then produce a new stream whichtransforms the stream's value incrementally (perhaps usingConverter.startChunkedConversion). The resulting streammay again be chunks of the result, but does not have tocorrespond to specific events from the source string.

Implementation

Stream<S> transform<S>(StreamTransformer<T, S> streamTransformer) {  return streamTransformer.bind(this);}