Struct ParSlice

pub struct ParSlice;

Utility struct for contructors for slices that allow unsynchronized access to their elements through UnsafeIndex and UnsafeChunkIndex.

Implementations

impl ParSlice

pub fn new<T: Default + Send + Sync>( len: usize, ) -> impl UnsafeIndex<T> + ParCollection<Box<[T]>>

Constructs a new slice with len elements, each initialized to T::default, that allows unsynchronized access to its elements through UnsafeIndex and that can be converted into a boxed slice.

Examples

let unsafe_slice = ParSlice::new(4);

unsafe {
    *unsafe_slice.get_mut(0) = 42;
}

assert_eq!(unsafe_slice.into().as_ref(), &[42, 0, 0, 0]);

pub fn with_value<T: Clone + Send + Sync>( value: T, len: usize, ) -> impl UnsafeIndex<T> + ParCollection<Box<[T]>>

Constructs a new slice with len elements, each initialized to value, that allows unsynchronized access to its elements through UnsafeIndex and that can be converted into a boxed slice.

Examples

let unsafe_slice = ParSlice::with_value(69, 4);

unsafe {
    *unsafe_slice.get_mut(0) = 42;
}

assert_eq!(unsafe_slice.into().as_ref(), &[42, 69, 69, 69]);

pub fn with_closure<T: Send + Sync>( closure: impl FnMut(usize) -> T, len: usize, ) -> impl UnsafeIndex<T> + ParCollection<Box<[T]>>

Constructs a new slice with len elements, each initialized to the return value of closure called with the index of the element to generate as an usize, that allows unsynchronized access to its elements through UnsafeIndex and that can be converted into a boxed slice.

Examples

let unsafe_slice = ParSlice::with_closure(|i| i, 4);

unsafe {
    *unsafe_slice.get_mut(0) = 42;
}

assert_eq!(unsafe_slice.into().as_ref(), &[42, 1, 2, 3]);

pub fn new_chunks<T: Default + Send + Sync>( len: usize, chunk_size: usize, ) -> impl UnsafeChunkIndex<T> + ParCollection<Box<[T]>>

Constructs a new slice with len elements, each initialized to T::default, that allows unsynchronized access to chunks of chunk_size of its elements through UnsafeChunkIndex and that can be converted into a boxed slice.

Examples

let unsafe_slice = ParSlice::new_chunks(4, 2);

unsafe {
    unsafe_slice.get_mut(0)[0] = 42;
}

assert_eq!(unsafe_slice.into().as_ref(), &[42, 0, 0, 0]);

pub fn chunks_with_value<T: Clone + Send + Sync>( value: T, len: usize, chunk_size: usize, ) -> impl UnsafeChunkIndex<T> + ParCollection<Box<[T]>>

Constructs a new slice with len elements, each initialized to value, that allows unsynchronized access to chunks of chunk_size of its elements through UnsafeChunkIndex and that can be converted into a boxed slice.

Examples

let unsafe_slice = ParSlice::chunks_with_value(69, 4, 2);

unsafe {
    unsafe_slice.get_mut(0)[0] = 42;
}

assert_eq!(unsafe_slice.into().as_ref(), &[42, 69, 69, 69]);

pub fn chunks_with_closure<T: Send + Sync>( closure: impl FnMut(usize) -> T, len: usize, chunk_size: usize, ) -> impl UnsafeChunkIndex<T> + ParCollection<Box<[T]>>

Constructs a new slice with len elements, each initialized to the return value of closure called with the index of the element to generate as an usize, that allows unsynchronized access to chunks of chunk_size of its elements through UnsafeChunkIndex and that can be converted into a boxed slice.

Examples

let unsafe_slice = ParSlice::chunks_with_closure(|i| i, 4, 2);

unsafe {
    unsafe_slice.get_mut(0)[0] = 42;
}

assert_eq!(unsafe_slice.into().as_ref(), &[42, 1, 2, 3]);