Struct ActorSelection

pub struct ActorSelection { /* private fields */ }

A selection represents part of the actor heirarchy, allowing messages to be sent to all actors in the selection.

There are several use cases where you would interact with actors via a selection instead of actor references:

• You know the path of an actor but you don’t have its ActorRef
• You want to broadcast a message to all actors within a path

ActorRef is almost always the better choice for actor interaction, since messages are directly sent to the actor’s mailbox without any preprocessing or cloning.

ActorSelection provides flexibility for the cases where at runtime the ActorRefs can’t be known. This comes at the cost of traversing part of the actor heirarchy and cloning messages.

A selection is anchored to an ActorRef and the path is relative to that actor’s path.

selection.try_tell() is used to message actors in the selection. Since a selection is a collection of BasicActorRefs messaging is un-typed. Messages not supported by any actor in the selection will be dropped.

Implementations

impl ActorSelection

pub fn new(anchor: BasicActorRef, path: String) -> Result<Self, InvalidPath>

pub fn try_tell<Msg>(&self, msg: Msg, sender: impl Into<Option<BasicActorRef>>)

where Msg: Message,

pub fn sys_tell(&self, msg: SystemMsg, sender: impl Into<Option<BasicActorRef>>)

Trait Implementations

impl Debug for ActorSelection

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.