Struct PtrConst 

pub struct PtrConst<'mem> { /* private fields */ }

A type-erased, read-only wide pointer to an initialized value.

Like PtrConst, but for unsized types where metadata is needed. Cannot be null (but may be dangling for ZSTs). The lifetime 'mem represents the borrow of the underlying memory, which must remain valid and initialized.

Implementations

impl<'mem> PtrConst<'mem>

pub const fn new<T: ?Sized>(ptr: NonNull<T>) -> Self

Creates a new wide const pointer from a raw pointer to a (potentially unsized) object.

Arguments

• ptr - Raw pointer to the object. Can be a pointer to a DST (e.g., slice, trait object).

Panics

Panics if a thin pointer is provided where a wide pointer is expected.

pub const fn as_byte_ptr(self) -> *const u8

Returns the underlying data pointer as a pointer to u8 (the address of the object).

pub const unsafe fn get<T: ?Sized>(self) -> &'mem T

Borrows the underlying object as a reference of type T.

Safety

• T must be the actual underlying (potentially unsized) type of the pointed-to memory.
• The memory must remain valid and not be mutated while this reference exists.
• The pointer must be correctly aligned and point to a valid, initialized value for type T.

pub const unsafe fn as_ptr<T: ?Sized>(self) -> *const T

Gets the underlying raw pointer as a pointer of type T

Safety

Must be called with the original type T that was used to create this pointer

pub const unsafe fn field(self, offset: usize) -> PtrConst<'mem>

Returns a pointer with the given offset added

Safety

Offset must be within the bounds of the allocated memory, and the resulting pointer must be properly aligned.

pub const unsafe fn read<T>(self) -> T

Exposes core::ptr::read

Safety

T must be the actual underlying type of the pointed-to memory. The memory must be properly initialized and aligned for type T.

Trait Implementations

impl<'mem> Clone for PtrConst<'mem>

fn clone(&self) -> PtrConst<'mem>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PtrConst<'_>

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

Formats the value using the given formatter.

impl<'mem, T: ?Sized> From<TypedPtrConst<'mem, T>> for PtrConst<'mem>

fn from(ptr: TypedPtrConst<'mem, T>) -> Self

Converts to this type from the input type.

impl IterItem for PtrConst<'_>

type Item<'a> = PtrConst<'a>

The output type of the iterator, bound by the lifetime 'a

impl<'mem> PartialEq for PtrConst<'mem>

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

impl<'mem> Eq for PtrConst<'mem>

impl<'mem> StructuralPartialEq for PtrConst<'mem>