ReceivePort abstract class

Together with SendPort, the only means of communication between isolates.

ReceivePorts have a sendPort getter which returns a SendPort. Any message that is sent through this SendPort is delivered to the ReceivePort it has been created from. There, the message is dispatched to the ReceivePort's listener.

A ReceivePort is a non-broadcast stream. This means that it buffers incoming messages until a listener is registered. Only one listener can receive messages. See Stream.asBroadcastStream for transforming the port to a broadcast stream.

A ReceivePort may have many SendPorts.

Implements

Constructors

ReceivePort()
factory

Opens a long-lived port for receiving messages.

ReceivePort.fromRawReceivePort(RawReceivePort rawPort)
factory

Creates a ReceivePort from a RawReceivePort.

Properties

sendPortSendPort
read-only

Returns a SendPort that sends to this receive port.

firstFuture
read-only, inherited

Returns the first element of the stream.

hashCodeint
read-only, inherited

The hash code for this object.

isBroadcastbool
read-only, inherited

Whether this stream is a broadcast stream.

isEmptyFuture<bool>
read-only, inherited

Reports whether this stream contains any elements.

lastFuture
read-only, inherited

Returns the last element of the stream.

lengthFuture<int>
read-only, inherited

Counts the elements in the stream.

runtimeTypeType
read-only, inherited

A representation of the runtime type of the object.

singleFuture
read-only, inherited

Returns the single element.

Operators

operator ==(other) → bool
inherited

The equality operator.

Methods

close() → void

Closes this.

listen(void onData(message), { Function onError, void onDone(), bool cancelOnError }) → StreamSubscription

Inherited from Stream.

any(bool test(T element)) → Future<bool>
inherited

Checks whether test accepts any element provided by this stream.

asBroadcastStream({void onListen(StreamSubscription<T> subscription), void onCancel(StreamSubscription<T> subscription) }) → Stream
inherited

Returns a multi-subscription stream that produces the same events as this.

asyncExpand<E>(Stream<E> convert(T event)) → Stream<E>
inherited

Creates a new stream with the events of a stream per original event.

asyncMap<E>(dynamic convert(T event)) → Stream<E>
inherited

Creates a new stream with each data event of this stream asynchronously mapped to a new event.

contains(Object needle) → Future<bool>
inherited

Checks whether needle occurs in the elements provided by this stream.

distinct([bool equals(T previous, T next) ]) → Stream
inherited

Skips data events if they are equal to the previous data event.

drain<E>([E futureValue ]) → Future<E>
inherited

Discards all data on the stream, but signals when it's done or an error occurred.

elementAt(int index) → Future
inherited

Returns the value of the indexth data event of this stream.

every(bool test(T element)) → Future<bool>
inherited

Checks whether test accepts all elements provided by this stream.

expand<S>(Iterable<S> convert(T value)) → Stream<S>
inherited

Creates a new stream from this stream that converts each element into zero or more events.

firstWhere(bool test(T element), { Object defaultValue() }) → Future
inherited

Finds the first element of this stream matching test.

fold<S>(S initialValue, S combine(S previous, T element)) → Future<S>
inherited

Reduces a sequence of values by repeatedly applying combine.

forEach(void action(T element)) → Future
inherited

Executes action on each data event of the stream.

handleError(Function onError, { bool test(error) }) → Stream
inherited

Creates a wrapper Stream that intercepts some errors from this stream.

join([String separator = "" ]) → Future<String>
inherited

Collects string of data events' string representations.

lastWhere(bool test(T element), { Object defaultValue() }) → Future
inherited

Finds the last element in this stream matching test.

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

Creates a new stream that converts each element of this stream to a new value using the convert function.

noSuchMethod(Invocation invocation) → dynamic
inherited

Invoked when a non-existent method or property is accessed.

pipe(StreamConsumer streamConsumer) → Future
inherited

Pipe the events of this stream into streamConsumer.

reduce(dynamic combine(T previous, T element)) → Future
inherited

Reduces a sequence of values by repeatedly applying combine.

singleWhere(bool test(T element)) → Future
inherited

Finds the single element in this stream matching test.

skip(int count) → Stream
inherited

Skips the first count data events from this stream.

skipWhile(bool test(T element)) → Stream
inherited

Skip data events from this stream while they are matched by test.

take(int count) → Stream
inherited

Provides at most the first count data events of this stream.

takeWhile(bool test(T element)) → Stream
inherited

Forwards data events while test is successful.

timeout(Duration timeLimit, { void onTimeout(EventSink<T> sink) }) → Stream
inherited

Creates a new stream with the same events as this stream.

toList() → Future<List>
inherited

Collects the data of this stream in a List.

toSet() → Future<Set>
inherited

Collects the data of this stream in a Set.

toString() → String
inherited

Returns a string representation of this object.

transform<S>(StreamTransformer<dynamic, S> streamTransformer) → Stream<S>
inherited

Chains this stream as the input of the provided StreamTransformer.

where(bool test(T event)) → Stream
inherited

Creates a new stream from this stream that discards some data events.

© 2012 the Dart project authors
Licensed under the Creative Commons Attribution-ShareAlike License v4.0.
https://api.dartlang.org/stable/1.24.3/dart-isolate/ReceivePort-class.html