Tok

Struct Tok 

Source
pub struct Tok<T: Internable> { /* private fields */ }
Expand description

A shared instance. Equality comparison costs two pointer comparisons. Ordering is by pointer value.

§Panics

If an interner was manually constructed, tokens from different interners cannot be compared and attempting to do so causes a panic.

Since a given Interner uses a single TypedInterner for each type, this is only possible if an Interner or TypedInterner was constructed besides the singleton.

Implementations§

Source§

impl<T: Internable> Tok<T>

Source

pub fn id(&self) -> NonZeroUsize

The pointer value of the token. If this is equal, equality comparison succeeds.

Source

pub fn interner_id(&self) -> NonZeroUsize

The pointer value of the interner. If this is different, comparison panics.

Source

pub fn usize(&self) -> usize

Cast into usize

Source

pub fn assert_comparable(&self, other: &Self)

Panic if the two tokens weren’t created with the same interner

Source

pub fn interner(&self) -> Arc<TypedInterner<T>>

Get the typed interner that owns this token.

Source

pub fn i<Q>(q: &Q) -> Self
where Q: ?Sized + Eq + Hash + ToOwned<Owned = T>, T: Borrow<Q>,

Source§

impl<T: Internable> Tok<Vec<Tok<T>>>

Source

pub fn ev(&self) -> Vec<T>

Extern all elements of the vector in a new vector. If the vector itself isn’t interned, use ev

Source§

impl<T: Internable> Tok<Vec<Tok<T>>>

Source

pub fn append(&self, suffix: impl IntoIterator<Item = Tok<T>>) -> Self

Add a suffix to the interned vector

Source

pub fn prepend(&self, prefix: impl IntoIterator<Item = Tok<T>>) -> Self

Add a prefix to the interned vector

Trait Implementations§

Source§

impl<T: Internable + AsRef<U>, U: ?Sized> AsRef<U> for Tok<T>

Source§

fn as_ref(&self) -> &U

Converts this type into a shared reference of the (usually inferred) input type.
Source§

impl<T: Internable> Borrow<T> for Tok<T>

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T: Clone + Internable> Clone for Tok<T>

Source§

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

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<T: Internable + Debug> Debug for Tok<T>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<T: Internable + Display> Display for Tok<T>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<T: Internable> Hash for Tok<T>

Source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

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

Feeds a slice of this type into the given Hasher. Read more
Source§

impl<T: Internable> Ord for Tok<T>

Source§

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 · Source§

fn max(self, other: Self) -> Self
where Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 · Source§

fn min(self, other: Self) -> Self
where Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 · Source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized,

Restrict a value to a certain interval. Read more
Source§

impl<T: Internable> PartialEq for Tok<T>

Source§

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl<T: Internable> PartialOrd for Tok<T>

Source§

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · Source§

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

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · Source§

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

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · Source§

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

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · Source§

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

Tests greater than or equal to (for self and other) and is used by the >= operator. Read more
Source§

impl<T: Internable> Deref for Tok<T>

Source§

type Target = T

The resulting type after dereferencing.
Source§

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

Dereferences the value.
Source§

impl<T: Internable> Eq for Tok<T>

Auto Trait Implementations§

§

impl<T> Freeze for Tok<T>

§

impl<T> RefUnwindSafe for Tok<T>
where T: RefUnwindSafe,

§

impl<T> Send for Tok<T>

§

impl<T> Sync for Tok<T>

§

impl<T> Unpin for Tok<T>

§

impl<T> UnwindSafe for Tok<T>
where T: RefUnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<P, T> Receiver for P
where P: Deref<Target = T> + ?Sized, T: ?Sized,

Source§

type Target = T

🔬This is a nightly-only experimental API. (arbitrary_self_types)
The target type on which the method may be called.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<_INNER> Internable for _INNER
where _INNER: Eq + Hash + Clone + Send + Sync + 'static,