Struct riker::actor::ActorSelection [−][src]
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 ActorRef
s 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>
[src]
impl<Msg: Message> ActorSelection<Msg>
Trait Implementations
impl<Msg: Debug + Message> Debug for ActorSelection<Msg>
[src]
impl<Msg: Debug + Message> Debug for ActorSelection<Msg>
fn fmt(&self, f: &mut Formatter) -> Result
[src]
fn fmt(&self, f: &mut Formatter) -> Result
Formats the value using the given formatter. Read more
impl<Msg: Message> Tell for ActorSelection<Msg>
[src]
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>>,
[src]
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>
[src]
impl<Msg: Message> SysTell for ActorSelection<Msg>
Auto Trait Implementations
impl<Msg> Send for ActorSelection<Msg>
impl<Msg> Send for ActorSelection<Msg>
impl<Msg> Sync for ActorSelection<Msg>
impl<Msg> Sync for ActorSelection<Msg>