pub struct Interned<'a, T>(pub &'a T, pub PrivateZst);
Expand description
A reference to a value that is interned, and is known to be unique.
Note that it is possible to have a T
and a Interned<T>
that are (or
refer to) equal but different values. But if you have two different
Interned<T>
s, they both refer to the same value, at a single location in
memory. This means that equality and hashing can be done on the value’s
address rather than the value’s contents, which can improve performance.
The PrivateZst
field means you can pattern match with Interned(v, _)
but you can only construct a Interned
with new_unchecked
, and not
directly.
Tuple Fields§
§0: &'a T
§1: PrivateZst
Implementations§
source§impl<'a, T> Interned<'a, T>
impl<'a, T> Interned<'a, T>
sourcepub const fn new_unchecked(t: &'a T) -> Self
pub const fn new_unchecked(t: &'a T) -> Self
Create a new Interned
value. The value referred to must be interned
and thus be unique, and it must remain unique in the future. This
function has _unchecked
in the name but is not unsafe
, because if
the uniqueness condition is violated condition it will cause incorrect
behaviour but will not affect memory safety.
Trait Implementations§
source§impl<T, CTX> HashStable<CTX> for Interned<'_, T>where
T: HashStable<CTX>,
impl<T, CTX> HashStable<CTX> for Interned<'_, T>where
T: HashStable<CTX>,
fn hash_stable(&self, hcx: &mut CTX, hasher: &mut StableHasher)
source§impl<'a, T: Ord> Ord for Interned<'a, T>
impl<'a, T: Ord> Ord for Interned<'a, T>
1.21.0 · source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
source§impl<'a, T: PartialOrd> PartialOrd for Interned<'a, T>
impl<'a, T: PartialOrd> PartialOrd for Interned<'a, T>
impl<'a, T> Copy for Interned<'a, T>
impl<'a, T> Eq for Interned<'a, T>
Auto Trait Implementations§
impl<'a, T> Freeze for Interned<'a, T>
impl<'a, T> RefUnwindSafe for Interned<'a, T>where
T: RefUnwindSafe,
impl<'a, T> Send for Interned<'a, T>where
T: Sync,
impl<'a, T> Sync for Interned<'a, T>where
T: Sync,
impl<'a, T> Unpin for Interned<'a, T>
impl<'a, T> UnwindSafe for Interned<'a, T>where
T: RefUnwindSafe,
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)source§impl<Q, K> Comparable<K> for Q
impl<Q, K> Comparable<K> for Q
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§impl<T> WithSubscriber for T
impl<T> WithSubscriber for T
source§fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
source§fn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
impl<'a, T> Captures<'a> for Twhere
T: ?Sized,
Layout§
Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...)
attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.
Size: 8 bytes