description

# ReceivePort class Null safety

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
  - Stream

## Constructors

ReceivePort()
  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. [...]
  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
sendPort → SendPort
  Returns a SendPort that sends to this receive port.
  read-only
single → Future
  The single element of this stream. [...]
  read-only, inherited

## 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 `this`. [...]
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
listen(void onData(dynamic message), {Function? onError, void onDone(), bool? cancelOnError}) → StreamSubscription
  Inherited 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 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 ==(Object other) → bool
  The equality operator. [...]
  inherited