Struct OxMut 

pub struct OxMut<'a> {
    pub shape: &'static Shape,
    /* private fields */
}

Safe mutable reference with shape.

Unlike OxPtrMut, this has a lifetime parameter for borrow checking.

Fields

shape: &'static Shape

The shape describing the type.

Implementations

impl<'a> OxMut<'a>

pub fn from_mut<T: Facet<'a> + ?Sized>(t: &'a mut T) -> Self

Create an OxMut from an actual Rust mutable reference.

This is the safe constructor - the lifetime 'a is captured from the reference, guaranteeing exclusive access for 'a.

pub const unsafe fn new(ptr: PtrMut, shape: &'static Shape) -> Self

Create an OxMut from a raw pointer and shape.

Safety

The caller must guarantee that:

• The pointer is valid and points to initialized data matching shape
• The caller has exclusive (mutable) access to the data for lifetime 'a
• The shape correctly describes the pointed-to type

Violating these invariants will cause undefined behavior when using safe methods like PartialEq::eq, core::fmt::Debug::fmt, etc.

pub const fn ptr(&self) -> PtrMut

Get the underlying pointer.

pub const fn shape(&self) -> &'static Shape

Get the shape.

pub const fn as_ref(&self) -> OxRef<'a>

Convert to an immutable OxRef.

pub const fn as_ptr_mut(&self) -> OxPtrMut

Convert to an unlifetimed OxPtrMut.

pub unsafe fn get_as_mut<T: 'static>( &mut self, expected_shape: &'static Shape, ) -> Option<&'a mut T>

Get a typed mutable reference if the shape matches.

Safety

The caller must ensure that T is the correct type for expected_shape.

Trait Implementations

impl<'a> Clone for OxMut<'a>

fn clone(&self) -> OxMut<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OxMut<'_>

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

Formats the value using the given formatter.

impl Display for OxMut<'_>

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

Formats the value using the given formatter.

impl From<OxMut<'_>> for OxPtrMut

fn from(ox: OxMut<'_>) -> Self

Converts to this type from the input type.

impl Hash for OxMut<'_>

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 OxMut<'_>

fn eq(&self, other: &Self) -> 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 PartialOrd for OxMut<'_>

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a> Copy for OxMut<'a>