ReceivePort 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.
- Implemented types
Constructors
- ReceivePort()
-
Opens a long-lived port for receiving messages. [...]
factory
- ReceivePort.fromRawReceivePort(RawReceivePort rawPort)
-
Creates a ReceivePort from a RawReceivePort. [...]
factory
Properties
- sendPort → SendPort
-
Returns a SendPort that sends to this receive port.
read-only
- first → Future
-
The first element of this stream. [...]
read-only, inherited
- hashCode → int
-
The hash code for this object. [...]
read-only, inherited
- isBroadcast → bool
-
Whether this stream is a broadcast stream.
read-only, inherited
-
isEmpty
→ Future<
bool> -
Whether this stream contains any elements. [...]
read-only, inherited
- last → Future
-
The last element of this stream. [...]
read-only, inherited
-
length
→ Future<
int> -
The number of elements in this stream. [...]
read-only, inherited
- runtimeType → Type
-
A representation of the runtime type of the object.
read-only, inherited
- single → Future
-
The single element of this stream. [...]
read-only, inherited
Methods
-
close(
) → void -
Closes
this
. [...] -
listen(
void onData(dynamic message), { Function onError, void onDone(), bool cancelOnError }) → StreamSubscription -
Inherited from Stream. [...]
override
-
any(
bool test(dynamic element)) → Future< bool> -
Checks whether
test
accepts any element provided by this stream. [...]inherited -
asBroadcastStream(
{void onListen(StreamSubscription subscription) void onCancel(StreamSubscription subscription) }) → Stream -
Returns a multi-subscription stream that produces the same events as this. [...]
inherited
-
asyncExpand<
E> (Stream< E> convert(dynamic event)) → Stream<E> -
Transforms each element into a sequence of asynchronous events. [...]
inherited
-
asyncMap<
E> (FutureOr< E> convert(dynamic event)) → Stream<E> -
Creates a new stream with each data event of this stream asynchronously
mapped to a new event. [...]
inherited
-
cast<
R> () → Stream< R> -
Adapt this stream to be a
Stream<R>
. [...]inherited -
contains(
Object needle) → Future< bool> -
Returns whether
needle
occurs in the elements provided by this stream. [...]inherited -
distinct(
[bool equals(dynamic previous dynamic next) ]) → Stream -
Skips data events if they are equal to the previous data event. [...]
inherited
-
drain<
E> ([E futureValue ]) → Future< E> -
Discards all data on this stream, but signals when it is done or an error
occurred. [...]
inherited
-
elementAt(
int index) → Future -
Returns the value of the
index
th data event of this stream. [...]inherited -
every(
bool test(dynamic element)) → Future< bool> -
Checks whether
test
accepts all elements provided by this stream. [...]inherited -
expand<
S> (Iterable< S> convert(dynamic element)) → Stream<S> -
Transforms each element of this stream into a sequence of elements. [...]
inherited
-
firstWhere(
bool test(dynamic element), { dynamic orElse() }) → Future -
Finds the first element of this stream matching
test
. [...]inherited -
fold<
S> (S initialValue, S combine(S previous, dynamic element)) → Future< S> -
Combines a sequence of values by repeatedly applying
combine
. [...]inherited -
forEach(
void action(dynamic element)) → Future -
Executes
action
on each element of this stream. [...]inherited -
handleError(
Function onError, { bool test(dynamic error) }) → Stream -
Creates a wrapper Stream that intercepts some errors from this stream. [...]
inherited
-
join(
[String separator = "" ]) → Future< String> -
Combines the string representation of elements into a single string. [...]
inherited
-
lastWhere(
bool test(dynamic element), { dynamic orElse() }) → Future -
Finds the last element in this stream matching
test
. [...]inherited -
map<
S> (S convert(dynamic event)) → Stream< S> -
Transforms each element of this stream into a new stream event. [...]
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent method or property is accessed. [...]
inherited
-
pipe(
StreamConsumer streamConsumer) → Future -
Pipes the events of this stream into
streamConsumer
. [...]inherited -
reduce(
dynamic combine(dynamic previous dynamic element)) → Future -
Combines a sequence of values by repeatedly applying
combine
. [...]inherited -
singleWhere(
bool test(dynamic element), { dynamic orElse() }) → Future -
Finds the single element in this stream matching
test
. [...]inherited -
skip(
int count) → Stream -
Skips the first
count
data events from this stream. [...]inherited -
skipWhile(
bool test(dynamic element)) → Stream -
Skip data events from this stream while they are matched by
test
. [...]inherited -
take(
int count) → Stream -
Provides at most the first
count
data events of this stream. [...]inherited -
takeWhile(
bool test(dynamic element)) → Stream -
Forwards data events while
test
is successful. [...]inherited -
timeout(
Duration timeLimit, { void onTimeout(EventSink sink) }) → Stream -
Creates a new stream with the same events as this stream. [...]
inherited
-
toList(
) → Future< List> -
Collects all elements of this stream in a List. [...]
inherited
-
toSet(
) → Future< Set> -
Collects the data of this stream in a Set. [...]
inherited
-
toString(
) → String -
Returns a string representation of this object.
inherited
-
transform<
S> (StreamTransformer< dynamic, S> streamTransformer) → Stream<S> -
Applies
streamTransformer
to this stream. [...]inherited -
where(
bool test(dynamic event)) → Stream -
Creates a new stream from this stream that discards some elements. [...]
inherited
Operators
-
operator ==(
dynamic other) → bool -
The equality operator. [...]
inherited