Struct TaggedPtr 

pub struct TaggedPtr(/* private fields */);

A pointer that uses the high bit (bit 63) as a tag to indicate wide vs thin.

• Bit 63 = 0: thin pointer (sized type, no metadata needed)
• Bit 63 = 1: wide pointer (unsized type, has metadata)

This works because user-space addresses on 64-bit Linux/macOS/Windows never use bit 63 (they’re limited to 48-57 bits).

Implementations

impl TaggedPtr

pub const fn thin(ptr: *mut u8) -> Self

Create a tagged pointer for a thin (sized) type.

pub fn wide(ptr: *mut u8) -> Self

Create a tagged pointer for a wide (unsized) type.

pub fn is_wide(self) -> bool

Returns true if this is a wide pointer (has metadata).

pub fn is_thin(self) -> bool

Returns true if this is a thin pointer (no metadata).

pub fn as_ptr(self) -> *mut u8

Returns the actual data pointer with the tag bit cleared.

pub const fn raw(self) -> *mut u8

Returns the raw tagged value (for debugging/testing).

pub unsafe fn with_offset(self, offset: usize) -> Self

Create a new TaggedPtr with an offset added, preserving the tag.

Safety

The offset must be within bounds of the allocation.

Trait Implementations

impl Clone for TaggedPtr

fn clone(&self) -> TaggedPtr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaggedPtr

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

Formats the value using the given formatter.

impl PartialEq for TaggedPtr

fn eq(&self, other: &TaggedPtr) -> 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 Copy for TaggedPtr

impl Eq for TaggedPtr

impl StructuralPartialEq for TaggedPtr