Struct Intern 

pub struct Intern<T: ?Sized>(/* private fields */);

A wrapper around Arc representing owned InternCache entries.

The wrapper type serves the purpose of semantic meaning only, implying that this value is cached in some way or another by this module.

We only conveniently allow obtaining the underlying Arc with a From but not the other way around. This means that interfacing code can make the type to “forget” it originated from an InternCache but not the other way around, i.e. cannot accidentally create fake entries that look like they came from an InternCache. If one really has to circumvent this, then the Intern::new_uncached_uninterned() method exists.

This ensures that interning is done everywhere that it’s expected, avoiding excess memory usage.

Implementations

impl<T: ?Sized> Intern<T>

pub fn new_uncached_uninterned(value: Arc<T>) -> Intern<T>

Creates an Intern from an arbitrary Arc.

The use of this is generally discouraged, as it effectively destroys the boundary of implying that certain cache entries come from the InternCache.

Trait Implementations

impl<T: Clone + ?Sized> Clone for Intern<T>

fn clone(&self) -> Intern<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug + ?Sized> Debug for Intern<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Default + ?Sized> Default for Intern<T>

fn default() -> Intern<T>

Returns the “default value” for a type.

impl<T: ?Sized> Deref for Intern<T>

type Target = Arc<T>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T: ?Sized> Display for Intern<T>

where Arc<T>: Display,

fn fmt(&self, __derive_more_f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Eq + ?Sized> Eq for Intern<T>

impl<'a, T: ?Sized> From<&'a Intern<T>> for &'a Arc<T>

fn from(value: &'a Intern<T>) -> Self

Converts to this type from the input type.

impl<T: ?Sized> From<Intern<T>> for Arc<T>

fn from(value: Intern<T>) -> Self

Converts to this type from the input type.

impl<T: Hash + ?Sized> Hash for Intern<T>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: PartialEq + ?Sized> PartialEq for Intern<T>

fn eq(&self, other: &Intern<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: PartialEq + ?Sized> StructuralPartialEq for Intern<T>