Struct WeakHandle 

pub struct WeakHandle { /* private fields */ }

Handle to an artifact that does not prevent the artifact from being unloaded.

Weak handles are primarily used when you want to use something that is already loaded.

For example, a strong handle to an artifact may be guaranteed to exist elsewhere in the program, and so you can simply get and use a weak handle to that artifact in other parts of your code. This removes reference counting overhead, but also ensures that the system which uses the weak handle is not in control of when to unload the artifact.

Implementations

impl WeakHandle

pub fn new(handle: Arc<ResolvedLoadHandle>) -> Self

Trait Implementations

impl ArtifactHandle for WeakHandle

fn resolved_load_handle(&self) -> &Arc<ResolvedLoadHandle>

fn load_state<T: LoadStateProvider>(&self, loader: &T) -> LoadState

Returns the load status of the artifact.

fn artifact_id<T: LoadStateProvider>(&self, loader: &T) -> ArtifactId

fn artifact<'a, T, S: TypedArtifactStorage<T>>( &self, storage: &'a S, ) -> Option<&'a T>

where Self: Sized,

Returns an immutable reference to the artifact if it is committed.

fn downgrade(&self) -> WeakHandle

Downgrades this handle into a WeakHandle.

fn load_handle(&self) -> LoadHandle

Returns the LoadHandle of this artifact handle.

fn direct_load_handle(&self) -> LoadHandle

impl Clone for WeakHandle

fn clone(&self) -> WeakHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WeakHandle

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

Formats the value using the given formatter.

impl Hash for WeakHandle

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for WeakHandle

fn eq(&self, other: &WeakHandle) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for WeakHandle

impl StructuralPartialEq for WeakHandle