dart:async

метод join

Объединяет строковое представление элементов в одну строку.

Каждый элемент преобразуется в строку с помощью метода Object.toString. Если предоставлен separator, он вставляется между строковыми представлениями элементов.

Возвращаемый future завершается объединённой строкой, когда этот поток завершён.

Если этот поток выдаёт ошибку или вызов Object.toString вызывает исключение, возвращаемый future завершается с этой ошибкой, и обработка прекращается.

Пример:

final result = await Stream.fromIterable(['Mars', 'Venus', 'Earth'])
    .join('--');
print(result); // 'Mars--Venus--Earth'

Реализация

Future<String> join([String separator = ""]) {
  _Future<String> result = new _Future<String>();
  StringBuffer buffer = new StringBuffer();
  bool first = true;
  StreamSubscription<T> subscription =
      this.listen(null, onError: result._completeError, onDone: () {
    result._complete(buffer.toString());
  }, cancelOnError: true);
  subscription.onData(separator.isEmpty
      ? (T element) {
          try {
            buffer.write(element);
          } catch (e, s) {
            _cancelAndErrorWithReplacement(subscription, result, e, s);
          }
        }
      : (T element) {
          if (!first) {
            buffer.write(separator);
          }
          first = false;
          try {
            buffer.write(element);
          } catch (e, s) {
            _cancelAndErrorWithReplacement(subscription, result, e, s);
          }
        });
  return result;
}