Struct ActorWeak 

pub struct ActorWeak<T: Actor> { /* private fields */ }

A weak, type-safe reference to an actor of type T.

ActorWeak<T> is a weak reference that does not prevent the actor from being dropped and can be upgraded to a strong ActorRef<T> if the actor is still alive. Like ActorRef<T>, it maintains compile-time type safety for the actor type T.

Creating ActorWeak<T>

ActorWeak<T> instances are created by calling downgrade on an existing ActorRef<T>:

let weak_ref = actor_ref.downgrade();

Upgrading to ActorRef<T>

An ActorWeak<T> can be upgraded to an ActorRef<T> using the upgrade method:

if let Some(strong_ref) = weak_ref.upgrade() {
    // Successfully upgraded, actor is still alive
    strong_ref.tell(MyMessage).await?;
} else {
    // Actor is no longer alive
}

Implementations

impl<T: Actor> ActorWeak<T>

pub fn upgrade(&self) -> Option<ActorRef<T>>

Attempts to upgrade the weak reference to a strong, type-safe reference.

Returns Some(ActorRef<T>) if the actor is still alive, or None if the actor has been dropped.

pub fn identity(&self) -> Identity

Returns the unique ID of the actor this weak reference points to.

pub fn is_alive(&self) -> bool

Checks if the actor might still be alive.

This method returns true if weak references can potentially be upgraded, but does not guarantee that a subsequent upgrade call will succeed due to potential race conditions.

Returns false if the actor is definitely dead (all strong references dropped).

Note: This is a heuristic check. For definitive actor state, always use upgrade and check the returned Option.

Trait Implementations

impl<T: Actor> Clone for ActorWeak<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug + Actor> Debug for ActorWeak<T>

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

Formats the value using the given formatter.

impl<T: Actor + 'static> From<&ActorWeak<T>> for Box<dyn WeakActorControl>

fn from(actor_weak: &ActorWeak<T>) -> Self

Converts to this type from the input type.

impl<T, M> From<&ActorWeak<T>> for Box<dyn WeakAskHandler<M, <T as Message<M>>::Reply>>

where T: Actor + Message<M> + 'static, M: Send + 'static, <T as Message<M>>::Reply: Send + 'static,

fn from(actor_weak: &ActorWeak<T>) -> Self

Converts to this type from the input type.

impl<T, M> From<&ActorWeak<T>> for Box<dyn WeakTellHandler<M>>

where T: Actor + Message<M> + 'static, M: Send + 'static,

fn from(actor_weak: &ActorWeak<T>) -> Self

Converts to this type from the input type.

impl<T: Actor + 'static> From<ActorWeak<T>> for Box<dyn WeakActorControl>

fn from(actor_weak: ActorWeak<T>) -> Self

Converts to this type from the input type.

impl<T, M> From<ActorWeak<T>> for Box<dyn WeakAskHandler<M, <T as Message<M>>::Reply>>

where T: Actor + Message<M> + 'static, M: Send + 'static, <T as Message<M>>::Reply: Send + 'static,

fn from(actor_weak: ActorWeak<T>) -> Self

Converts to this type from the input type.

impl<T, M> From<ActorWeak<T>> for Box<dyn WeakTellHandler<M>>

where T: Actor + Message<M> + 'static, M: Send + 'static,

fn from(actor_weak: ActorWeak<T>) -> Self

Converts to this type from the input type.

impl<T: Actor + 'static> WeakActorControl for ActorWeak<T>

fn identity(&self) -> Identity

Returns the unique identity of the actor.

fn is_alive(&self) -> bool

Checks if the actor might still be alive (heuristic, not guaranteed).

fn upgrade(&self) -> Option<Box<dyn ActorControl>>

Attempts to upgrade to a strong control reference. Returns None if the actor has been dropped.

fn clone_boxed(&self) -> Box<dyn WeakActorControl>

Clone this control into a new boxed instance.

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

Debug formatting support for trait objects.

impl<T, M> WeakAskHandler<M, <T as Message<M>>::Reply> for ActorWeak<T>

where T: Actor + Message<M> + 'static, M: Send + 'static, <T as Message<M>>::Reply: Send + 'static,

fn upgrade(&self) -> Option<Box<dyn AskHandler<M, <T as Message<M>>::Reply>>>

Attempts to upgrade to a strong handler. Returns None if the actor has been dropped.

fn clone_boxed(&self) -> Box<dyn WeakAskHandler<M, <T as Message<M>>::Reply>>

Clone this handler into a new boxed instance.

fn as_weak_control(&self) -> &dyn WeakActorControl

Returns a reference to WeakActorControl for lifecycle management.

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

Debug formatting support for trait objects.

impl<T, M> WeakTellHandler<M> for ActorWeak<T>

where T: Actor + Message<M> + 'static, M: Send + 'static,

fn upgrade(&self) -> Option<Box<dyn TellHandler<M>>>

Attempts to upgrade to a strong handler. Returns None if the actor has been dropped.

fn clone_boxed(&self) -> Box<dyn WeakTellHandler<M>>

Clone this handler into a new boxed instance.

fn as_weak_control(&self) -> &dyn WeakActorControl

Returns a reference to WeakActorControl for lifecycle management.

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

Debug formatting support for trait objects.