Struct RcWeakAnchor 

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

A wrapper around std::rc::Weak<T> that opts into 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 is resolved through the YAML anchor context; it is rejected when no matching strong anchor is available.

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> 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> 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> Debug for RcWeakAnchor<T>

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

Formats the value using the given formatter.

impl<T> Eq for RcWeakAnchor<T>

impl<T> From<&Rc<T>> for RcWeakAnchor<T>

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

Converts to this type from the input type.

impl<T> From<&RcAnchor<T>> for RcWeakAnchor<T>

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

Converts to this type from the input type.

impl<T> PartialEq for RcWeakAnchor<T>

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

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.