Struct bones_asset::SBox

pub struct SBox<T>where
    T: HasSchema,{ /* private fields */ }

A typed version of SchemaBox.

This allows to use SBox<T> extremely similar to a Box<T> except that it can be converted to and from a SchemaBox for compatibility with the schema ecosystem.

Also, compared to a SchemaBox, it is more efficient to access, because it avoids extra runtime checks for a matching schema after it has been created, and doesn’t need to be cast to T upon every access.

Implementations

impl<T> SBox<T>where T: HasSchema,

pub fn new(value: T) -> SBox<T>

Create a new SBox.

pub fn into_schema_box(self) -> SchemaBox

Convert into a SchemaBox

Trait Implementations

impl<T> Clone for SBox<T>where T: HasSchema,

fn clone(&self) -> SBox<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for SBox<T>where T: HasSchema + Debug,

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

Formats the value using the given formatter.

impl<T> Default for SBox<T>where T: HasSchema,

fn default() -> SBox<T>

Returns the “default value” for a type.

impl<T> Deref for SBox<T>where T: HasSchema,

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &<SBox<T> as Deref>::Target

Dereferences the value.

impl<T> DerefMut for SBox<T>where T: HasSchema,

fn deref_mut(&mut self) -> &mut <SBox<T> as Deref>::Target

Mutably dereferences the value.

impl<T> From<SBox<T>> for SchemaBoxwhere T: HasSchema,

fn from(value: SBox<T>) -> SchemaBox

Converts to this type from the input type.

impl<T> HasSchema for SBox<T>where T: HasSchema,

fn schema() -> &'static Schema

Get this type’s [Schema].

fn register_schema()

Register this schema with the global schema registry.

fn cast<T>(this: &Self) -> &Twhere T: HasSchema,

Cast a reference of this type to a reference of another type with the same memory layout.

fn try_cast<T>(this: &Self) -> Result<&T, SchemaMismatchError>where T: HasSchema,

Cast a reference of this type to a reference of another type with the same memory layout.

fn cast_mut<T>(this: &mut Self) -> &mut Twhere T: HasSchema,

Cast a mutable reference of this type to a reference of another type with the same memory layout.

fn try_cast_mut<T>(this: &mut Self) -> Result<&mut T, SchemaMismatchError>where T: HasSchema,

Cast a mutable reference of this type to a reference of another type with the same memory layout.

fn as_schema_ref(&self) -> SchemaRef<'_>where Self: Sized,

Converts a reference of T to a SchemaRef

fn as_schema_mut(&mut self) -> SchemaRefMut<'_>where Self: Sized,

Converts a reference of T to a SchemaRefMut

impl<T> TryFrom<SchemaBox> for SBox<T>where T: HasSchema,

type Error = SchemaBox

The type returned in the event of a conversion error.

fn try_from( value: SchemaBox ) -> Result<SBox<T>, <SBox<T> as TryFrom<SchemaBox>>::Error>

Performs the conversion.