Struct ArcWeakAnchor 

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

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

This variant is thread-safe and uses Arc / [Weak] instead of Rc. If the weak reference is dangling, it serializes as null.

Deserialization note: null → dangling weak. Non-null is rejected unless a registry is used.

Examples

use std::sync::Arc;
use serde_saphyr::{ArcAnchor, ArcWeakAnchor};

let arc_anchor = ArcAnchor::from(Arc::new(String::from("Thread-safe")));

// Create a weak anchor from the strong reference
let weak_anchor = ArcWeakAnchor::from(&arc_anchor.0);

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

Tuple Fields

0: Weak<T>

Implementations

impl<T: ?Sized> ArcWeakAnchor<T>

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

Try to upgrade the weak reference to Arc<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 ArcWeakAnchor<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

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

where T: Deserialize<'de> + Send + Sync + '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<&Arc<T>> for ArcWeakAnchor<T>

fn from(arc: &Arc<T>) -> Self

Converts to this type from the input type.

impl<T: ?Sized> From<&ArcAnchor<T>> for ArcWeakAnchor<T>

fn from(ara: &ArcAnchor<T>) -> Self

Converts to this type from the input type.

impl<T: ?Sized> From<Arc<T>> for ArcWeakAnchor<T>

fn from(arc: Arc<T>) -> Self

Converts to this type from the input type.

impl<T: ?Sized> PartialEq for ArcWeakAnchor<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 ArcWeakAnchor<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 ArcWeakAnchor<T>