Struct riker::actor::ActorSelection

pub struct ActorSelection<Msg: Message> { /* fields omitted */ }

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.

If a selection.tell results in the message being sent to zero actors, the message is sent to dead letters.

Methods

impl<Msg: Message> ActorSelection<Msg>

pub fn new(     anchor: &ActorRef<Msg>,     path: &str ) -> Result<ActorSelection<Msg>, InvalidPath>

Trait Implementations

impl<Msg: Debug + Message> Debug for ActorSelection<Msg>

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

Formats the value using the given formatter.

impl<Msg: Message> Tell for ActorSelection<Msg>

type Msg = Msg

fn tell<T>(&self, msg: T, sender: Option<ActorRef<Self::Msg>>) where     T: Into<ActorMsg<Self::Msg>>,

Implement to provide message routing to actors, e.g. ActorRef and ActorSelection

impl<Msg: Message> SysTell for ActorSelection<Msg>

type Msg = Msg

fn sys_tell(&self, msg: SystemMsg<Msg>, sender: Option<ActorRef<Msg>>)