Struct RcRecursive 

pub struct RcRecursive<T>(pub Rc<RefCell<Option<T>>>);

Available on crate feature std only.

Single-threaded recursive anchor type for cyclic / late-initialised YAML graphs.

Wraps Rc<RefCell<Option<T>>> so a value can be referenced by an alias before the anchor is fully populated — the canonical shape for self-referential YAML configs (call graphs, scene trees, doubly-linked structures emitted as anchor + alias).

Access through RcRecursive::borrow / RcRecursive::borrow_mut (not Deref) so the interior mutability is always explicit at the call site — borrow-checker complaints surface in the YAML code, not in the surrounding logic.

For thread-safe variants see ArcRecursive.

Examples

use noyalib::RcRecursive;
let r: RcRecursive<String> = RcRecursive::empty();
assert!(r.borrow().is_none());
r.set("hello".to_string());
assert_eq!(r.borrow().as_deref(), Some("hello"));

Tuple Fields

0: Rc<RefCell<Option<T>>>

Implementations

impl<T> RcRecursive<T>

pub fn empty() -> Self

Construct an empty (uninitialised) recursive anchor.

Examples

use noyalib::RcRecursive;
let r: RcRecursive<i32> = RcRecursive::empty();
assert!(r.borrow().is_none());

pub fn new(value: T) -> Self

Construct a recursive anchor pre-populated with value.

Examples

use noyalib::RcRecursive;
let r = RcRecursive::new(7_i64);
assert_eq!(r.borrow().as_ref().copied(), Some(7));

pub fn borrow(&self) -> Ref<'_, Option<T>>

Borrow the inner value immutably (runtime-checked).

pub fn borrow_mut(&self) -> RefMut<'_, Option<T>>

Borrow the inner value mutably (runtime-checked).

pub fn set(&self, value: T) -> Option<T>

Replace the inner value, returning the previous one if any.

Examples

use noyalib::RcRecursive;
let r = RcRecursive::empty();
assert!(r.set(1_i32).is_none());
assert_eq!(r.set(2_i32), Some(1));

pub fn take(&self) -> Option<T>

Drop the inner value, returning it if any.

pub fn strong_count(&self) -> usize

Number of strong Rc references to this recursive cell.

pub fn downgrade(&self) -> RcRecursion<T>

Downgrade to an RcRecursion weak reference. Useful to break alias-only cycles when the anchored value is referenced from multiple places — the weak reference does not count towards the strong-count, so cycle storage is released as soon as the last strong RcRecursive drops.

Trait Implementations

impl<T> Clone for RcRecursive<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for RcRecursive<T>

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

Formats the value using the given formatter.

impl<T> Default for RcRecursive<T>

fn default() -> Self

Returns the “default value” for a type.

impl<'de, T: Deserialize<'de>> Deserialize<'de> for RcRecursive<T>

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: Serialize> Serialize for RcRecursive<T>

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

where S: Serializer,

Serialize this value into the given Serde serializer.