Struct TaggedMutRef

pub struct TaggedMutRef<'a, T, const BITS: usize>(/* private fields */);

Mutable version of TaggedRef.

Like TaggedRef, this type stores a reference and an integer tag, but the reference in this type is mutable.

BITS specifies how many bits are used for the tag. The alignment of T must be large enough to store this many bits: if BITS is larger than the base-2 logarithm of the alignment of T¹, panics or compilation errors will occur.

---

1. Because alignment is always a power of 2, this is equal to align_of::<T>().trailing_zeros(). ↩

Implementations

impl<'a, T, const BITS: usize> TaggedMutRef<'a, T, BITS>

pub fn new(reference: &'a mut T, tag: usize) -> Self

Creates a new tagged mutable reference. Only the lower BITS bits of tag are stored.

impl<T, const BITS: usize> TaggedMutRef<'_, T, BITS>

pub const BITS: u32

The number of tag bits that this tagged reference can store.

pub const MAX_TAG: usize

The maximum tag (inclusive) that this tagged reference can store. Equal to (1 << BITS) - 1 (i.e., one less than 2 to the power of BITS).

impl<'a, T, const BITS: usize> TaggedMutRef<'a, T, BITS>

pub unsafe fn new_unchecked(reference: &'a mut T, tag: usize) -> Self

Equivalent to Self::new but without some runtime checks.

Safety

tag cannot be greater than Self::MAX_TAG.

pub fn to_tagged_ref(&self) -> TaggedRef<'_, T, BITS>

Creates an immutable TaggedRef with the same reference and tag.

This method reborrows the reference; see also Self::into_tagged_ref, which preserves the lifetime.

pub fn into_tagged_ref(self) -> TaggedRef<'a, T, BITS>

Converts the tagged reference into an immutable TaggedRef.

Self::to_tagged_ref reborrows the reference instead of consuming the TaggedMutRef.

pub fn get(&self) -> (&T, usize)

Returns an immutable reborrow of the reference stored by the tagged reference, along with a copy of the tag.

See Self::get_mut if you need a mutable reference.

pub fn get_mut(&mut self) -> (&mut T, usize)

Returns a mutable reborrow of the reference stored by the tagged reference, along with a copy of the tag.

pub fn into_inner(self) -> (&'a mut T, usize)

Deconstructs the tagged reference into its constituent parts: the reference (with the original lifetime 'a) and the tag.

pub fn get_ref(&self) -> &T

Returns an immutable reborrow of the reference stored by the tagged reference.

See Self::get_mut_ref if you need a mutable reference.

pub fn get_mut_ref(&mut self) -> &mut T

Returns a mutable reborrow of the reference stored by the tagged reference.

pub fn into_ref(self) -> &'a mut T

Gets the reference stored by the tagged reference with its original lifetime ('a), consuming the tagged reference in the process.

Equivalent to Self::into_inner().0.

pub fn set_ref(&mut self, reference: &'a mut T)

Sets the reference without modifying the tag.

This method is equivalent to:

*self = self.with_ref(reference);

Because this method mutates the tagged reference in-place, the new reference must have the exact same lifetime, 'a. As a consequence, any data currently borrowed for 'a by the old reference will remain borrowed even once the reference is updated.

Self::with_ref may be more flexible in some situations, as it returns a new tagged reference that can have a different lifetime.

pub fn with_ref<'b>(&self, reference: &'b mut T) -> TaggedMutRef<'b, T, BITS>

Creates a new tagged reference with the same tag but a different reference.

This method is equivalent to:

TaggedMutRef::new(reference, self.tag())

pub fn tag(&self) -> usize

Gets the tag stored by the tagged reference. Equivalent to self.get().1.

pub fn set_tag(&mut self, tag: usize)

Sets the tag without modifying the reference.

This method behaves like the following, but it doesn’t require ownership of the tagged reference:

// Error: can't call `into_ref` on `&mut Self`.
*self = Self::new(self.into_ref(), tag);

pub fn reborrow(&mut self) -> TaggedMutRef<'_, T, BITS>

Creates a new tagged reference that reborrows the referenced data with a different lifetime.

This method is equivalent to:

let (reference, tag) = self.get_mut();
TaggedMutRef::new(reference, tag)

Trait Implementations

impl<T, const BITS: usize> AsMut<T> for TaggedMutRef<'_, T, BITS>

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

Converts this type into a mutable reference of the (usually inferred) input type.

impl<T, const BITS: usize> AsRef<T> for TaggedMutRef<'_, T, BITS>

fn as_ref(&self) -> &T

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

impl<T, const BITS: usize> Debug for TaggedMutRef<'_, T, BITS>

where T: Debug,

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

Formats the value using the given formatter.

impl<T, const BITS: usize> Hash for TaggedMutRef<'_, T, BITS>

where T: Hash,

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

Hashes self.get().

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, const BITS: usize> Ord for TaggedMutRef<'_, T, BITS>

where T: Ord,

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

Returns self.get().cmp(&other.get()).

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

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

where Self: Sized,

Restrict a value to a certain interval.

impl<T, const BITS: usize> PartialEq for TaggedMutRef<'_, T, BITS>

where T: PartialEq,

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

Returns self.get() == other.get().

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, const BITS: usize> PartialOrd for TaggedMutRef<'_, T, BITS>

where T: PartialOrd,

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

Returns self.get().partial_cmp(&other.get()).

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl<T, const BITS: usize> Pointer for TaggedMutRef<'_, T, BITS>

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

Formats the value using the given formatter.

impl<T, const BITS: usize> Eq for TaggedMutRef<'_, T, BITS>

where T: Eq,

impl<T, const BITS: usize> Send for TaggedMutRef<'_, T, BITS>

where T: Send,

impl<T, const BITS: usize> Sync for TaggedMutRef<'_, T, BITS>

where T: Sync,