Struct RcWeakAnchor 

#[repr(transparent)]
pub struct RcWeakAnchor<T: ?Sized>(pub Weak<T>);

Serialization public API is defined at crate root A wrapper around [Weak<T>] (from std::rc) that opt-ins for anchor emission.

When serialized, if the weak reference is dangling (i.e., the value was dropped), it emits null to indicate that the target no longer exists. Provides convenience methods like upgrade and is_dangling.

Note on deserialization: null deserializes back into a dangling weak (Weak::new()). Non-null cannot be safely reconstructed into a Weak without a shared registry; we reject it. Ask if you want an ID/registry-based scheme to restore sharing.

Examples

use std::rc::Rc;
use serde_saphyr::{RcAnchor, RcWeakAnchor};

let rc_anchor = RcAnchor::from(Rc::new(String::from("Persistent")));

// Create a weak anchor from a strong reference
let weak_anchor = RcWeakAnchor::from(&rc_anchor.0);

assert!(weak_anchor.upgrade().is_some());
drop(rc_anchor);
assert!(weak_anchor.upgrade().is_none());

Tuple Fields

0: Weak<T>

Implementations

impl<T: ?Sized> RcWeakAnchor<T>

pub fn upgrade(&self) -> Option<Rc<T>>

Try to upgrade the weak reference to Rc<T>. Returns None if the value has been dropped.

pub fn is_dangling(&self) -> bool

Returns true if the underlying value has been dropped (no strong refs remain).

Trait Implementations

impl<T: Clone + ?Sized> Clone for RcWeakAnchor<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: ?Sized> Debug for RcWeakAnchor<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for RcWeakAnchor<T>

where T: Deserialize<'de> + 'static,

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: ?Sized> From<&Rc<T>> for RcWeakAnchor<T>

fn from(rc: &Rc<T>) -> Self

Converts to this type from the input type.

impl<T: ?Sized> From<&RcAnchor<T>> for RcWeakAnchor<T>

fn from(rca: &RcAnchor<T>) -> Self

Converts to this type from the input type.

impl<T: ?Sized> From<Rc<T>> for RcWeakAnchor<T>

fn from(rc: Rc<T>) -> Self

Converts to this type from the input type.

impl<T: ?Sized> PartialEq for RcWeakAnchor<T>

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<T: Serialize> Serialize for RcWeakAnchor<T>

fn serialize<S: Serializer>(&self, s: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl<T: ?Sized> Eq for RcWeakAnchor<T>