Struct AlignedVec 

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

Cache-line-aligned vector wrapper.

On most modern x86-64 and ARM processors the cache line is 64 bytes. Aligning the start of a data buffer to a 64-byte boundary avoids false sharing between cores and helps the prefetcher.

Internally this uses a standard VecT` whose pointer is guaranteed to be at least 64-byte aligned via a manual allocation strategy when the default allocator does not already satisfy the requirement. On the vast majority of platforms with jemalloc or mimalloc, 64-byte alignment for large arrays is already the default, so this mainly serves as a documented guarantee.

Implementations

impl<T: Default + Clone> AlignedVec<T>

pub fn new(len: usize) -> Self

Create a new aligned vector of len default-initialised elements.

impl<T: Clone> AlignedVec<T>

pub fn from_vec(v: Vec<T>) -> Self

Wrap an existing VecT`.

If the existing allocation is already aligned, no re-allocation occurs.

pub fn as_slice(&self) -> &[T]

Return a shared slice over the data.

pub fn as_mut_slice(&mut self) -> &mut [T]

Return a mutable slice over the data.

pub fn len(&self) -> usize

Number of elements.

pub fn is_empty(&self) -> bool

Whether the vector is empty.

Trait Implementations

impl<T: Clone> Clone for AlignedVec<T>

fn clone(&self) -> AlignedVec<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Clone> Debug for AlignedVec<T>

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

Formats the value using the given formatter.