description

# reduce method

Future<T> reduce(

1. T combine(
   1. T previous,
   2. T element
   )

)

Combines a sequence of values by repeatedly applying `combine`.

Similar to Iterable.reduce, this function maintains a value, starting with the first element of this stream and updated for each further element of this stream. For each element after the first, the value is updated to the result of calling `combine` with the previous value and the element.

When this stream is done, the returned future is completed with the value at that time.

If this stream is empty, the returned future is completed with an error. If this stream emits an error, or the call to `combine` throws, the returned future is completed with that error, and processing is stopped.

Example:

    final result = await Stream.fromIterable([2, 6, 10, 8, 2])
        .reduce((previous, element) => previous + element);
    print(result); // 28

## Implementation

    Future<T> reduce(T combine(T previous, T element)) {
      @pragma('vm:awaiter-link')
      _Future<T> result = _Future<T>();
      bool seenFirst = false;
      late T value;
      StreamSubscription<T> subscription = this.listen(
        null,
        onError: result._completeError,
        onDone: () {
          if (!seenFirst) {
            var stack = StackTrace.current;
            var error = IterableElementError.noElement();
            _trySetStackTrace(error, stack);
            _completeWithErrorCallback(result, error, stack);
          } else {
            result._complete(value);
          }
        },
        cancelOnError: true,
      );
      subscription.onData((T element) {
        if (seenFirst) {
          _runUserCode(() => combine(value, element), (T newValue) {
            value = newValue;
          }, _cancelAndErrorClosure(subscription, result));
        } else {
          value = element;
          seenFirst = true;
        }
      });
      return result;
    }