Struct ObjectArc

#[repr(C)]
pub struct ObjectArc<T: ObjectCore> { /* private fields */ }

Arc-like wrapper for Object that allows shared ownership

\tparam T The type of the object to be wrapped

Implementations

impl<T: ObjectCore> ObjectArc<T>

pub fn new(data: T) -> Self

Allocate an initialized object at its stable managed address.

pub fn new_with_extra_items<U>(data: T) -> Self

where T: ObjectCoreWithExtraItems<ExtraItem = U>,

Allocate a stable object followed by its type’s extra item storage.

pub unsafe fn from_raw(ptr: *const T) -> Self

Move a previously allocated object into the ObjectArc

Arguments

• ptr - The raw pointer to move into the ObjectArc

Returns

• ObjectArc<T> - The ObjectArc \return The ObjectArc

Safety

ptr must own one strong reference to a live, stable managed allocation whose dynamic type is compatible with T and whose payload is valid. Ownership of that reference is transferred into the returned handle.

pub unsafe fn into_raw(this: Self) -> *const T

Move the ObjectArc into a raw pointer

Arguments

• this - The ObjectArc to move into a raw pointer

Returns

• *const T - The raw pointer

pub unsafe fn as_raw(this: &Self) -> *const T

Get the raw pointer from the ObjectArc

Caller should view this as a non-owning reference

Arguments

• this - The ObjectArc to get the raw pointer

Returns

• *const T - The raw pointer \return The raw pointer

Safety

Access must respect existing borrows, and the pointer cannot outlive an owning handle. The object and header must not be moved or replaced.

pub unsafe fn as_raw_mut(this: &mut Self) -> *mut T

Get the raw mutable pointer from the ObjectArc

Caller should view this as a non-owning reference

Arguments

• this - The ObjectArc to get the raw pointer

Returns

• *mut T - The raw pointer

Safety

The handle need not be unique. The caller must establish exclusive access for each mutation and must not move or replace the object or its header.

pub fn strong_count(this: &Self) -> usize

Get the strong reference count of the ObjectArc

Arguments

• this - The ObjectArc to get the strong reference count

Returns

• usize - The strong reference count

pub fn weak_count(this: &Self) -> usize

Get the weak reference count of the ObjectArc

Arguments

• this - The ObjectArc to get the weak reference count

Returns

• usize - The weak reference count

Trait Implementations

impl<T: ObjectCore> Clone for ObjectArc<T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: ObjectCore> Deref for ObjectArc<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T: ObjectCore> Drop for ObjectArc<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: Send + Sync + ObjectCore> Send for ObjectArc<T>

impl<T: Send + Sync + ObjectCore> Sync for ObjectArc<T>