ring/polyfill/slice/
as_chunks_mut.rs

Help
// Copyright 2025 Brian Smith.
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
// SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
// OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
// CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

use super::AsChunks;

#[inline(always)]
pub fn as_chunks_mut<T, const N: usize>(slice: &mut [T]) -> (AsChunksMut<T, N>, &mut [T]) {
    assert!(N != 0, "chunk size must be non-zero");
    let len = slice.len() / N;
    let (multiple_of_n, remainder) = slice.split_at_mut(len * N);
    (AsChunksMut(multiple_of_n), remainder)
}

pub struct AsChunksMut<'a, T, const N: usize>(&'a mut [T]);

impl<T, const N: usize> AsChunksMut<'_, T, N> {
    #[inline(always)]
    pub fn as_flattened(&self) -> &[T] {
        self.0
    }

    #[inline(always)]
    pub fn as_flattened_mut(&mut self) -> &mut [T] {
        self.0
    }

    #[cfg(target_arch = "aarch64")]
    pub fn as_ptr(&self) -> *const [T; N] {
        self.0.as_ptr().cast()
    }

    #[cfg(target_arch = "x86_64")]
    pub fn as_ptr(&self) -> *const [T; N] {
        self.0.as_ptr().cast()
    }

    #[cfg(target_arch = "aarch64")]
    pub fn as_mut_ptr(&mut self) -> *mut [T; N] {
        self.0.as_mut_ptr().cast()
    }

    #[cfg(target_arch = "x86_64")]
    #[inline(always)]
    pub fn as_mut(&mut self) -> AsChunksMut<T, N> {
        AsChunksMut(self.0)
    }

    #[inline(always)]
    pub fn as_ref(&self) -> AsChunks<T, N> {
        AsChunks::<T, N>::from(self)
    }

    // Argument moved from runtime argument to `const` argument so that
    // `CHUNK_LEN * N` is checked at compile time for overflow.
    #[inline(always)]
    pub fn chunks_mut<const CHUNK_LEN: usize>(&mut self) -> AsChunksMutChunksMutIter<T, N> {
        AsChunksMutChunksMutIter(self.0.chunks_mut(CHUNK_LEN * N))
    }

    #[cfg(target_arch = "x86_64")]
    #[inline(always)]
    pub fn split_at_mut(&mut self, mid: usize) -> (AsChunksMut<T, N>, AsChunksMut<T, N>) {
        let (before, after) = self.0.split_at_mut(mid * N);
        (AsChunksMut(before), AsChunksMut(after))
    }
}

pub struct AsChunksMutChunksMutIter<'a, T, const N: usize>(core::slice::ChunksMut<'a, T>);

impl<'a, T, const N: usize> Iterator for AsChunksMutChunksMutIter<'a, T, N> {
    type Item = AsChunksMut<'a, T, N>;

    #[inline(always)]
    fn next(&mut self) -> Option<Self::Item> {
        self.0.next().map(AsChunksMut)
    }
}
ring/polyfill/slice/as_chunks_mut.rs

ring/polyfill/slice/
as_chunks_mut.rs
