Struct AlignedBuffer 

pub struct AlignedBuffer { /* private fields */ }

SIMD-aligned buffer with metadata

This buffer guarantees proper alignment for SIMD operations using direct memory allocation. It supports SSE (16-byte), AVX2 (32-byte), and AVX-512 (64-byte) alignments.

Implementations

impl AlignedBuffer

pub fn new(capacity: usize, alignment: usize) -> DomainResult<Self>

Create new aligned buffer with guaranteed SIMD alignment

Arguments

• capacity - Minimum capacity in bytes
• alignment - Required alignment (must be power of 2)

Safety

This function uses unsafe code to allocate aligned memory. The memory is properly tracked and will be deallocated on drop.

pub fn new_sse(capacity: usize) -> DomainResult<Self>

Create an aligned buffer with specific SIMD level

pub fn new_avx2(capacity: usize) -> DomainResult<Self>

Create an aligned buffer for AVX2 operations

pub fn new_avx512(capacity: usize) -> DomainResult<Self>

Create an aligned buffer for AVX-512 operations

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

Get mutable slice to buffer data

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

Get immutable slice to buffer data

pub fn as_mut_capacity_slice(&mut self) -> &mut [u8]

Get a mutable slice with full capacity

pub unsafe fn set_len(&mut self, new_len: usize)

Set the length of valid data

Safety

Caller must ensure that new_len bytes are initialized

pub fn reserve(&mut self, additional: usize) -> DomainResult<()>

Reserve additional capacity

pub fn extend_from_slice(&mut self, data: &[u8]) -> DomainResult<()>

Push bytes to the buffer

pub fn clear(&mut self)

Clear buffer contents but keep allocated memory

pub fn capacity(&self) -> usize

Get buffer capacity

pub fn len(&self) -> usize

Get current length of valid data

pub fn is_empty(&self) -> bool

Check if buffer is empty

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

Get the raw pointer to the buffer

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

Get the mutable raw pointer to the buffer

pub fn is_aligned(&self) -> bool

Check if buffer is properly aligned

This validates that the buffer pointer has the requested alignment, which is critical for SIMD operations.

pub fn actual_alignment(&self) -> usize

Get the actual alignment of the buffer

pub fn is_simd_compatible(&self, simd_type: SimdType) -> bool

Verify buffer is suitable for specific SIMD instruction set

Trait Implementations

impl Clone for AlignedBuffer

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AlignedBuffer

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

Formats the value using the given formatter.

impl Drop for AlignedBuffer

fn drop(&mut self)

Executes the destructor for this type.

impl Send for AlignedBuffer

impl Sync for AlignedBuffer