Struct crossbeam_epoch::Owned
source · [−]Expand description
An owned heap-allocated object.
This type is very similar to Box<T>
.
The pointer must be properly aligned. Since it is aligned, a tag can be stored into the unused least significant bits of the address.
Implementations
Returns a new owned pointer pointing to raw
.
This function is unsafe because improper use may lead to memory problems. Argument raw
must be a valid pointer. Also, a double-free may occur if the function is called twice on
the same raw pointer.
Panics
Panics if raw
is not properly aligned.
Safety
The given raw
should have been derived from Owned
, and one raw
should not be converted
back by Owned::from_raw()
multiple times.
Examples
use crossbeam_epoch::Owned;
let o = unsafe { Owned::from_raw(Box::into_raw(Box::new(1234))) };
Converts the owned pointer into a Box
.
Examples
use crossbeam_epoch::Owned;
let o = Owned::new(1234);
let b: Box<i32> = o.into_box();
assert_eq!(*b, 1234);
Allocates value
on the heap and returns a new owned pointer pointing to it.
Examples
use crossbeam_epoch::Owned;
let o = Owned::<i32>::init(1234);
Returns the tag stored within the pointer.
Examples
use crossbeam_epoch::Owned;
assert_eq!(Owned::new(1234).tag(), 0);
Returns the same pointer, but tagged with tag
. tag
is truncated to be fit into the
unused bits of the pointer to T
.
Examples
use crossbeam_epoch::Owned;
let o = Owned::new(0u64);
assert_eq!(o.tag(), 0);
let o = o.with_tag(2);
assert_eq!(o.tag(), 2);
Trait Implementations
Auto Trait Implementations
impl<T: ?Sized> RefUnwindSafe for Owned<T> where
T: RefUnwindSafe,
impl<T: ?Sized> UnwindSafe for Owned<T> where
T: UnwindSafe,
Blanket Implementations
Mutably borrows from an owned value. Read more