# map<S> method

Stream<S> map <S>(S convert(T event))

Transforms each element of this stream into a new stream event.

Creates a new stream that converts each element of this stream to a new value using the `convert` function, and emits the result.

For each data event, `o`, in this stream, the returned stream provides a data event with the value `convert(o)`. If `convert` throws, the returned stream reports it as an error event instead.

Error and done events are passed through unchanged to the returned stream.

The returned stream is a broadcast stream if this stream is. The `convert` function is called once per data event per listener. If a broadcast stream is listened to more than once, each subscription will individually call `convert` on each data event.

## Implementation

    Stream<S> map<S>(S convert(T event)) {
      return new _MapStream<T, S>(this, convert);
    }