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
- Available Extensions
Constructors
- ReceivePort([String debugName = ''])
-
Opens a long-lived port for receiving messages.
factory
- ReceivePort.fromRawReceivePort(RawReceivePort rawPort)
-
Creates a ReceivePort from a RawReceivePort.
factory
Properties
- first → Future
-
The first element of this stream.
no setterinherited
- hashCode → int
-
The hash code for this object.
no setterinherited
- isBroadcast → bool
-
Whether this stream is a broadcast stream.
no setterinherited
-
isEmpty
→ Future<
bool> -
Whether this stream contains any elements.
no setterinherited
- last → Future
-
The last element of this stream.
no setterinherited
-
length
→ Future<
int> -
The number of elements in this stream.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- sendPort → SendPort
-
A SendPort which sends messages to this receive port.
no setter
- single → Future
-
The single element of this stream.
no setterinherited
Methods
-
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 -
close(
) → void - Closes the receive port.
-
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< void> -
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 -
listen(
void onData(dynamic message)?, {Function? onError, void onDone()?, bool? cancelOnError}) → StreamSubscription -
Listen for events from Stream.
override
-
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 nonexistent 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 -
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 ==(
Object other) → bool -
The equality operator.
inherited