Struct KStepPointer 

pub struct KStepPointer<T> { /* private fields */ }

Strided pointer to T. Stride = sizeof(T) << k_step bytes.

Implementations

impl<T> KStepPointer<T>

pub const SIGNATURE: AxisMask

Direction signature of KStepPointer<T>. Engages the K_stride axis (stride encoded as log2 shift count, no runtime stride: usize field).

pub const unsafe fn new(base: *const T, k_step: u8) -> Self

New strided pointer. k_step is the log2 of the stride multiplier; the actual byte stride is sizeof(T) << k_step.

Safety

base must point to a valid T and the strided sequence base + i * stride must remain valid for all indices the caller will use.

pub const unsafe fn tight(base: *const T) -> Self

Tight-packed strided pointer (K_step = 0).

Safety

Same as Self::new: base must point to a contiguous run of T for every index the caller will use.

pub const unsafe fn cache_line(base: *const T) -> Self

Cache-line strided pointer (K_step chosen so stride >= 64 bytes). Walks every 64/sizeof(T) elements.

Safety

Same as Self::new: base must remain valid for every index the caller will use under the chosen k_step stride.

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

pub const fn k_step(&self) -> u8

pub const fn stride(&self) -> usize

Byte stride between consecutive elements.

pub unsafe fn at(&self, i: usize) -> *const T

Pointer to the i-th element under the current stride.

Safety

The caller must ensure base + i * stride is in bounds.

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

Borrow the i-th element.

Safety

i must be in bounds; the strided sequence at this index must point to a valid T.

pub unsafe fn iter(&self, count: usize) -> StridedIter<'_, T>

Iterator over count strided elements.

Safety

All count strided positions must be in bounds.

Trait Implementations

impl<T> Clone for KStepPointer<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Copy for KStepPointer<T>

impl<T: Debug> Debug for KStepPointer<T>

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

Formats the value using the given formatter.

impl<T: Send> Send for KStepPointer<T>

impl<T: Sync> Sync for KStepPointer<T>