Struct crossbeam_epoch::Owned [−][src]
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
impl<T> Owned<T>
[src]
pub unsafe fn from_raw(raw: *mut T) -> Owned<T>
[src]
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))) };
pub fn into_box(self) -> Box<T>
[src]
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);
pub fn new(init: T) -> Owned<T>
[src]
Allocates value
on the heap and returns a new owned pointer pointing to it.
Examples
use crossbeam_epoch::Owned; let o = Owned::new(1234);
impl<T: ?Sized + Pointable> Owned<T>
[src]
pub fn init(init: T::Init) -> Owned<T>
[src]
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);
pub fn into_shared<'g>(self, _: &'g Guard) -> Shared<'g, T>
[src]
Converts the owned pointer into a Shared
.
Examples
use crossbeam_epoch::{self as epoch, Owned}; let o = Owned::new(1234); let guard = &epoch::pin(); let p = o.into_shared(guard);
pub fn tag(&self) -> usize
[src]
Returns the tag stored within the pointer.
Examples
use crossbeam_epoch::Owned; assert_eq!(Owned::new(1234).tag(), 0);
pub fn with_tag(self, tag: usize) -> Owned<T>
[src]
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
impl<T: ?Sized + Pointable> AsMut<T> for Owned<T>
[src]
impl<T: ?Sized + Pointable> AsRef<T> for Owned<T>
[src]
impl<T: ?Sized + Pointable> Borrow<T> for Owned<T>
[src]
impl<T: ?Sized + Pointable> BorrowMut<T> for Owned<T>
[src]
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T: Clone> Clone for Owned<T>
[src]
fn clone(&self) -> Self
[src]
pub fn clone_from(&mut self, source: &Self)
1.0.0[src]
impl<T: ?Sized + Pointable> Debug for Owned<T>
[src]
impl<T: ?Sized + Pointable> Deref for Owned<T>
[src]
impl<T: ?Sized + Pointable> DerefMut for Owned<T>
[src]
impl<T: ?Sized + Pointable> Drop for Owned<T>
[src]
impl<T> From<Box<T, Global>> for Owned<T>
[src]
impl<T: ?Sized + Pointable> From<Owned<T>> for Atomic<T>
[src]
fn from(owned: Owned<T>) -> Self
[src]
Returns a new atomic pointer pointing to owned
.
Examples
use crossbeam_epoch::{Atomic, Owned}; let a = Atomic::<i32>::from(Owned::new(1234));
impl<T> From<T> for Owned<T>
[src]
impl<T: ?Sized + Pointable> Pointer<T> for Owned<T>
[src]
fn into_usize(self) -> usize
[src]
unsafe fn from_usize(data: usize) -> Self
[src]
Returns a new pointer pointing to the tagged pointer data
.
Panics
Panics if the data is zero in debug mode.
Auto Trait Implementations
impl<T: ?Sized> RefUnwindSafe for Owned<T> where
T: RefUnwindSafe,
T: RefUnwindSafe,
impl<T: ?Sized> Send for Owned<T> where
T: Send,
T: Send,
impl<T: ?Sized> Sync for Owned<T> where
T: Sync,
T: Sync,
impl<T: ?Sized> Unpin for Owned<T>
impl<T: ?Sized> UnwindSafe for Owned<T> where
T: UnwindSafe,
T: UnwindSafe,
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<!> for T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn clone_into(&self, target: &mut T)
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,