#[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
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());
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);
Maps the ARef’s target to something reachable from the target.
Example
use reffers::ARef;
let aref: ARef<[u8]> = vec![0u8, 5, 7].into();
assert_eq!(*aref.map(|s| &s[1]), 5);
Trait Implementations
This method returns an ordering between self
and other
values if one exists. Read more
This method tests less than (for self
and other
) and is used by the <
operator. Read more
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
This method tests greater than (for self
and other
) and is used by the >
operator. Read more