#[repr(C)]pub struct ARef<'a, U: ?Sized> { /* private fields */ }
Expand description
ARef - a reference that abstracts the owner completely.
ARef takes over where OwningRef ends, by abstracting the owner even further.
This makes it possible to return, say, an ARef<str>
and have the caller drop the owner
when done looking at it, without having to bother about whether the owner is a String
, Rc<String>
, a
Ref<String>
, or something else.
If you want an ARef that’s restricted to Send types, use ARefs, and if you want an ARef that’s restricted to Send + Sync types, use ARefss.
Oh, and it’s repr(C), so it can be transferred over an FFI boundary (if its target is repr(C), too).
Example
use std::rc::Rc;
use reffers::ARef;
struct CountDown(pub Rc<String>);
impl CountDown {
pub fn idx_to_str(&self, idx: u32) -> ARef<str> {
match idx {
0 => "Go!".into(),
// We clone the Rc instead of the String
// for performance,
// then we map from &String to &str
1 => ARef::new(self.0.clone()).map(|s| &**s),
_ => format!("{}...", idx).into(),
}
}
}
let c = CountDown(Rc::new("Ready!".into()));
assert_eq!(&*c.idx_to_str(3), "3...");
assert_eq!(&*c.idx_to_str(2), "2...");
assert_eq!(&*c.idx_to_str(1), "Ready!");
assert_eq!(&*c.idx_to_str(0), "Go!");
Implementations§
source§impl<'a, U: Descend> ARef<'a, U>
impl<'a, U: Descend> ARef<'a, U>
sourcepub fn descend_from(x: Self) -> ARef<'a, <U::Inner as Deref>::Target>
pub fn descend_from(x: Self) -> ARef<'a, <U::Inner as Deref>::Target>
Descends from a ARef<RefCell
Example
use std::sync::{Arc, RwLock};
use reffers::ARef;
let x = Arc::new(RwLock::new("Hello!"));
{
let aref = ARef::new(x.clone());
let hello = ARef::descend_from(aref);
// The RwLock is now read locked
assert_eq!(*hello, "Hello!");
assert!(x.try_write().is_err());
}
// The lock is released when the ARef goes out of scope
assert!(x.try_write().is_ok());
source§impl<'a, U: ?Sized> ARef<'a, U>
impl<'a, U: ?Sized> ARef<'a, U>
sourcepub fn new<O>(owner: O) -> Selfwhere
O: 'a + AReffic + Deref<Target = U>,
pub fn new<O>(owner: O) -> Selfwhere
O: 'a + AReffic + Deref<Target = U>,
Creates a new ARef from what the ARef points to.
Example
use std::rc::Rc;
use reffers::ARef;
let aref = ARef::new(Rc::new(43));
assert_eq!(*aref, 43);