Struct crossbeam_epoch::Owned [] [src]

pub struct Owned<T> { /* fields omitted */ }

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.

Methods

impl<T> Owned<T>
[src]

[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);

[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.

Examples

use crossbeam_epoch::Owned;

let o = unsafe { Owned::from_raw(Box::into_raw(Box::new(1234))) };

[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);

Important traits for Box<R>
[src]

Converts the owned pointer into a Box.

Examples

use crossbeam_epoch::{self as epoch, Owned};

let o = Owned::new(1234);
let b: Box<i32> = o.into_box();
assert_eq!(*b, 1234);

[src]

Returns the tag stored within the pointer.

Examples

use crossbeam_epoch::Owned;

assert_eq!(Owned::new(1234).tag(), 0);

[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> From<Owned<T>> for Atomic<T>
[src]

[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> Pointer<T> for Owned<T>
[src]

[src]

Returns the machine representation of the pointer.

[src]

Returns a new pointer pointing to the tagged pointer data.

Panics

Panics if the data is zero in debug mode.

impl<T> Drop for Owned<T>
[src]

[src]

Executes the destructor for this type. Read more

impl<T> Debug for Owned<T>
[src]

[src]

Formats the value using the given formatter. Read more

impl<T: Clone> Clone for Owned<T>
[src]

[src]

Returns a copy of the value. Read more

1.0.0
[src]

Performs copy-assignment from source. Read more

impl<T> Deref for Owned<T>
[src]

The resulting type after dereferencing.

Important traits for &'a mut I
[src]

Dereferences the value.

impl<T> DerefMut for Owned<T>
[src]

Important traits for &'a mut I
[src]

Mutably dereferences the value.

impl<T> From<T> for Owned<T>
[src]

[src]

Performs the conversion.

impl<T> From<Box<T>> for Owned<T>
[src]

[src]

Returns a new owned pointer pointing to b.

Panics

Panics if the pointer (the Box) is not properly aligned.

Examples

use crossbeam_epoch::Owned;

let o = unsafe { Owned::from_raw(Box::into_raw(Box::new(1234))) };

impl<T> Borrow<T> for Owned<T>
[src]

Important traits for &'a mut I
[src]

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for Owned<T>
[src]

Important traits for &'a mut I
[src]

Mutably borrows from an owned value. Read more

impl<T> AsRef<T> for Owned<T>
[src]

Important traits for &'a mut I
[src]

Performs the conversion.

impl<T> AsMut<T> for Owned<T>
[src]

Important traits for &'a mut I
[src]

Performs the conversion.