Struct netstack3_core::sync::StrongRc

pub struct StrongRc<T> { /* private fields */ }

A strongly-held reference.

Similar to an alloc::sync::Arc but holding a Strong acts as a witness to the live-ness of the underlying data. That is, holding a Strong implies that the underlying data has not yet been destroyed.

Note that Strong’s implementation of Hash and PartialEq operate on the pointer itself and not the underlying data.

Implementations

impl<T> Strong<T>

pub fn downgrade(_: &Strong<T>) -> Weak<T>

Returns a weak reference pointing to the same underlying data.

pub fn debug_id(&self) -> impl Debug

Returns core::fmt::Debug implementation that is stable and unique for the data held behind this Strong.

pub fn marked_for_destruction(_: &Strong<T>) -> bool

Returns true if the inner value has since been marked for destruction.

pub fn weak_ptr_eq(_: &Strong<T>, _: &Weak<T>) -> bool

Returns true if the two pointers point to the same allocation.

pub fn ptr_eq(_: &Strong<T>, _: &Strong<T>) -> bool

Returns true if the two pointers point to the same allocation.

pub fn ptr_cmp(_: &Strong<T>, _: &Strong<T>) -> Ordering

Compares the two pointers.

pub fn debug_references(this: &Strong<T>) -> DebugReferences<T>

Creates a DebugReferences instance.

Trait Implementations

impl<T> AsRef<T> for Strong<T>

fn as_ref(&self) -> &T

Converts this type into a shared reference of the (usually inferred) input type.

impl<I, D, BT> Borrow<Strong<ReferenceState<I, D, Icmp<BT>>>> for IcmpSocketId<I, D, BT>

where I: IpExt, D: WeakDeviceIdentifier, BT: IcmpEchoBindingsTypes,

fn borrow(&self) -> &Strong<ReferenceState<I, D, Icmp<BT>>>

Immutably borrows from an owned value.

impl<I, D, BT> Borrow<Strong<ReferenceState<I, D, Udp<BT>>>> for UdpSocketId<I, D, BT>

where I: IpExt, D: WeakDeviceIdentifier, BT: UdpBindingsTypes,

fn borrow(&self) -> &Strong<ReferenceState<I, D, Udp<BT>>>

Immutably borrows from an owned value.

impl<T> Clone for Strong<T>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Strong<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<T> Deref for Strong<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T> Drop for Strong<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<I, D, BT> From<Strong<ReferenceState<I, D, Icmp<BT>>>> for IcmpSocketId<I, D, BT>

where I: IpExt, D: WeakDeviceIdentifier, BT: IcmpEchoBindingsTypes,

fn from(value: Strong<ReferenceState<I, D, Icmp<BT>>>) -> IcmpSocketId<I, D, BT>

Converts to this type from the input type.

impl<I, D, BT> From<Strong<ReferenceState<I, D, Udp<BT>>>> for UdpSocketId<I, D, BT>

where I: IpExt, D: WeakDeviceIdentifier, BT: UdpBindingsTypes,

fn from(value: Strong<ReferenceState<I, D, Udp<BT>>>) -> UdpSocketId<I, D, BT>

Converts to this type from the input type.

impl<T> Hash for Strong<T>

fn hash<H>(&self, state: &mut H)

where H: Hasher,

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<BT> IpAddressId<Ipv4Addr> for Strong<Ipv4AddressEntry<BT>>

where BT: IpDeviceStateBindingsTypes,

type Weak = Weak<Ipv4AddressEntry<BT>>

The weak version of this ID.

fn downgrade( &self, ) -> <Strong<Ipv4AddressEntry<BT>> as IpAddressId<Ipv4Addr>>::Weak

Downgrades this ID to a weak reference.

fn addr(&self) -> IpDeviceAddr<Ipv4Addr>

Returns the address this ID represents.

fn addr_sub( &self, ) -> AddrSubnet<Ipv4Addr, NonMulticastAddr<NonMappedAddr<SpecifiedAddr<Ipv4Addr>>>>

Returns the address subnet this ID represents.

impl<BT> IpAddressId<Ipv6Addr> for Strong<Ipv6AddressEntry<BT>>

where BT: IpDeviceStateBindingsTypes,

type Weak = Weak<Ipv6AddressEntry<BT>>

The weak version of this ID.

fn downgrade( &self, ) -> <Strong<Ipv6AddressEntry<BT>> as IpAddressId<Ipv6Addr>>::Weak

Downgrades this ID to a weak reference.

fn addr(&self) -> IpDeviceAddr<Ipv6Addr>

Returns the address this ID represents.

fn addr_sub(&self) -> AddrSubnet<Ipv6Addr, NonMappedAddr<UnicastAddr<Ipv6Addr>>>

Returns the address subnet this ID represents.

impl<T> PartialEq for Strong<T>

fn eq(&self, other: &Strong<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> Eq for Strong<T>