Struct Weak

#[repr(C)]
pub struct Weak<T, Alloc: IAlloc = DefaultAllocator> { /* private fields */ }

alloc::sync::Weak, but ABI-stable.

Implementations

impl<T, Alloc: IAlloc> Weak<T, Alloc>

where Struct<AllocPtr<T, Alloc>>: IStable, AllocPtr<T, Alloc>: IStable,

pub const fn has_optimal_layout() -> bool

Returns true if the layout for Weak is smaller or equal to that Rust would have generated for it.

impl<T, Alloc: IAlloc> Weak<T, Alloc>

pub const fn into_raw(this: Self) -> AllocPtr<T, Alloc>

Returns the pointer to the inner raw allocation, leaking this.

Note that the pointer may be dangling if T is zero-sized.

pub const unsafe fn from_raw(this: AllocPtr<T, Alloc>) -> Self

Constructs Self from a raw allocation.

Safety

this MUST not be dangling, and have been obtained through Self::into_raw.

pub fn upgrade(&self) -> Option<Arc<T, Alloc>>

Attempts to upgrade self into an Arc.

Trait Implementations

impl<T, Alloc: IAlloc> Clone for Weak<T, Alloc>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T, Alloc: IAlloc> Drop for Weak<T, Alloc>

fn drop(&mut self)

Executes the destructor for this type.

impl<T, Alloc: IAlloc> From<&Arc<T, Alloc>> for Weak<T, Alloc>

fn from(value: &Arc<T, Alloc>) -> Self

Converts to this type from the input type.

impl<T, Alloc: IAlloc> From<&Weak<T, Alloc>> for Weak<T, Alloc>

fn from(value: &Weak<T, Alloc>) -> Self

Converts to this type from the input type.

impl<T, Alloc: IAlloc> IPtrClone for Weak<T, Alloc>

fn clone(this: &Self) -> Self

Clone the pointer.

impl<T, Alloc: IAlloc> IPtrOwned for Weak<T, Alloc>

fn drop( this: &mut ManuallyDrop<Self>, _drop: unsafe extern "C" fn(AnonymRefMut<'_>), )

Called instead of Drop::drop when the dynptr is dropped.

impl<T, Alloc: IAlloc> IStable for Weak<T, Alloc>

where Struct<AllocPtr<T, Alloc>>: IStable, AllocPtr<T, Alloc>: IStable,

const REPORT: &'static TypeReport

A compile-time generated report of the fields of the type, allowing for compatibility inspection.

const ID: u64

A stable (and ideally unique) identifier for the type. Often generated using crate::report::gen_id, but can be manually set.

type ForbiddenValues = <Struct<AllocPtr<T, Alloc>> as IStable>::ForbiddenValues

The values that the annotated type cannot occupy.

type UnusedBits = <Struct<AllocPtr<T, Alloc>> as IStable>::UnusedBits

The padding bits in the annotated types

type Size = <Struct<AllocPtr<T, Alloc>> as IStable>::Size

The size of the annotated type in bytes.

type Align = <Struct<AllocPtr<T, Alloc>> as IStable>::Align

The alignment of the annotated type in bytes.

type HasExactlyOneNiche = <Struct<AllocPtr<T, Alloc>> as IStable>::HasExactlyOneNiche

Allows the detection of whether or not core::option::Options are stable:

type ContainsIndirections = <Struct<AllocPtr<T, Alloc>> as IStable>::ContainsIndirections

Whether or not the type contains indirections (pointers, indices in independent data-structures…)

fn size() -> usize

Returns the size of the type.

fn align() -> usize

Returns the alignment of the type.

unsafe fn is_invalid(ptr: *const u8) -> bool

Returns true if ptr points to memory that cannot be a valid value of Self.

impl<T, Alloc: IAlloc> IntoDyn for Weak<T, Alloc>

type Anonymized = Weak<(), Alloc>

A pointer type with type information discarded.

type Target = T

The original pointee.

fn anonimize(self) -> Self::Anonymized

Drop the type information from the pointer.

impl<T: Send + Sync, Alloc: IAlloc + Send + Sync> Send for Weak<T, Alloc>

impl<T: Send + Sync, Alloc: IAlloc + Send + Sync> Sync for Weak<T, Alloc>