pub struct Unique<T: ?Sized> { /* fields omitted */ }🔬 This is a nightly-only experimental API. (ptr_internals)
use NonNull instead and consider PhantomData<T> (if you also use #[may_dangle]), Send, and/or Sync
A wrapper around a raw non-null *mut T that indicates that the possessor
of this wrapper owns the referent. Useful for building abstractions like
Box<T>, Vec<T>, String, and HashMap<K, V>.
Unlike *mut T, Unique<T> behaves "as if" it were an instance of T.
It implements Send/Sync if T is Send/Sync. It also implies
the kind of strong aliasing guarantees an instance of T can expect:
the referent of the pointer should not be modified without a unique path to
its owning Unique.
If you're uncertain of whether it's correct to use Unique for your purposes,
consider using NonNull, which has weaker semantics.
Unlike *mut T, the pointer must always be non-null, even if the pointer
is never dereferenced. This is so that enums may use this forbidden value
as a discriminant -- Option<Unique<T>> has the same size as Unique<T>.
However the pointer may still dangle if it isn't dereferenced.
Unlike *mut T, Unique<T> is covariant over T. This should always be correct
for any type which upholds Unique's aliasing requirements.
🔬 This is a nightly-only experimental API. (ptr_internals)
Creates a new Unique that is dangling, but well-aligned.
This is useful for initializing types which lazily allocate, like
Vec::new does.
🔬 This is a nightly-only experimental API. (ptr_internals)
Creates a new Unique.
ptr must be non-null.
🔬 This is a nightly-only experimental API. (ptr_internals)
Creates a new Unique if ptr is non-null.
🔬 This is a nightly-only experimental API. (ptr_internals)
Acquires the underlying *mut pointer.
🔬 This is a nightly-only experimental API. (ptr_internals)
Dereferences the content.
The resulting lifetime is bound to self so this behaves "as if"
it were actually an instance of T that is getting borrowed. If a longer
(unbound) lifetime is needed, use &*my_ptr.as_ptr().
🔬 This is a nightly-only experimental API. (ptr_internals)
Mutably dereferences the content.
The resulting lifetime is bound to self so this behaves "as if"
it were actually an instance of T that is getting borrowed. If a longer
(unbound) lifetime is needed, use &mut *my_ptr.as_ptr().
Formats the value using the given formatter. Read more
Unique pointers are Send if T is Send because the data they
reference is unaliased. Note that this aliasing invariant is
unenforced by the type system; the abstraction using the
Unique must enforce it.
Unique pointers are Sync if T is Sync because the data they
reference is unaliased. Note that this aliasing invariant is
unenforced by the type system; the abstraction using the
Unique must enforce it.
Performs copy-assignment from source. Read more
Formats the value using the given formatter.