Skip to main content

Handle

Struct Handle 

Source
pub struct Handle<A: Asset> { /* private fields */ }
Expand description

Cheap shared reference to a lazy resource; clones share success or failure.

Implementations§

Source§

impl<A: Asset> Handle<A>

Source

pub fn state(&self) -> AssetState<A>

Current state without triggering a file read or decode.

This is a non-authoritative snapshot for polling and diagnostics: another thread may change it immediately after the call. Handle::get is the only call that loads, and a Ready or Failed state is sticky.

Source

pub fn get(&self) -> Result<Arc<A>>

Resolves this handle synchronously, joining one concurrent decode. User decoder panics become sticky asset errors. Decoders must not recursively resolve the same handle. Returned resources are immutable.

Source

pub fn get_with(&self, diagnostics: &RequestDiagnostics) -> Result<Arc<A>>

Resolves into an explicit request sink, including when called on another thread.

Source

pub fn source_name(&self) -> String

Resource path or embedded key, suitable for diagnostic display.

Trait Implementations§

Source§

impl<A: Asset> Clone for Handle<A>

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<A: Asset> Debug for Handle<A>

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<A> !RefUnwindSafe for Handle<A>

§

impl<A> !UnwindSafe for Handle<A>

§

impl<A> Forget for Handle<A>

§

impl<A> Freeze for Handle<A>
where Arc<Entry<A>>: Freeze,

§

impl<A> Move for Handle<A>

§

impl<A> Send for Handle<A>
where Arc<Entry<A>>: Send,

§

impl<A> Sync for Handle<A>
where Arc<Entry<A>>: Sync,

§

impl<A> Unpin for Handle<A>
where Arc<Entry<A>>: Unpin,

§

impl<A> UnsafeUnpin for Handle<A>
where Arc<Entry<A>>: UnsafeUnpin,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.