Struct rkyv::rel_ptr::RawRelPtr

#[repr(transparent)]
pub struct RawRelPtr<O> { /* fields omitted */ }

An untyped pointer which resolves relative to its position in memory.

Implementations

impl<O: Offset> RawRelPtr<O>

pub unsafe fn manual_check_bytes<'a, C: Fallible + ?Sized>(
    value: *const Self,
    context: &mut C
) -> Result<&'a Self, Infallible> where
    O: CheckBytes<C>, 

Checks the bytes of the given raw relative pointer.

This is done rather than implementing CheckBytes to force users to manually write their CheckBytes implementation since they need to also provide the ownership model of their memory.

Safety

The given pointer must be aligned and point to enough bytes to represent a RawRelPtr.

impl<O: Offset> RawRelPtr<O>

pub unsafe fn try_emplace(
    from: usize,
    to: usize,
    out: *mut Self
) -> Result<(), OffsetError>

Attempts to create a new RawRelPtr in-place between the given from and to positions.

Safety

• out must be located at position from
• to must be a position within the archive

pub unsafe fn emplace(from: usize, to: usize, out: *mut Self)

Creates a new RawRelPtr in-place between the given from and to positions.

Safety

• out must be located at position from
• to must be a position within the archive
• The offset between from and to must fit in an isize and not exceed the offset storage

pub fn base(&self) -> *const u8

Gets the base pointer for the relative pointer.

pub fn base_mut(&mut self) -> *mut u8

Gets the mutable base pointer for the relative pointer.

pub fn offset(&self) -> isize

Gets the offset of the relative pointer from its base.

pub fn is_null(&self) -> bool

Gets whether the offset of the relative pointer is 0.

pub fn as_ptr(&self) -> *const ()

Calculates the memory address being pointed to by this relative pointer.

pub fn as_mut_ptr(&mut self) -> *mut ()

Returns an unsafe mutable pointer to the memory address being pointed to by this relative pointer.

Trait Implementations

impl<O: Debug> Debug for RawRelPtr<O>

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

Formats the value using the given formatter.