Trait SliceExt 

pub trait SliceExt {
    type Item;

    // Required methods
    fn bitcoin_as_chunks<const N: usize>(
        &self,
    ) -> (&[[Self::Item; N]], &[Self::Item]);
    fn bitcoin_as_chunks_mut<const N: usize>(
        &mut self,
    ) -> (&mut [[Self::Item; N]], &mut [Self::Item]);
    fn get_array<const ARRAY_LEN: usize>(
        &self,
        offset: usize,
    ) -> Option<&[Self::Item; ARRAY_LEN]>;
    fn split_first_chunk<const ARRAY_LEN: usize>(
        &self,
    ) -> Option<(&[Self::Item; ARRAY_LEN], &[Self::Item])>;
    fn split_last_chunk<const ARRAY_LEN: usize>(
        &self,
    ) -> Option<(&[Self::Item], &[Self::Item; ARRAY_LEN])>;
}

Extension trait for slice.

Required Associated Types

type Item

The item type the slice is storing.

Required Methods

fn bitcoin_as_chunks<const N: usize>( &self, ) -> (&[[Self::Item; N]], &[Self::Item])

Splits up the slice into a slice of arrays and a remainder.

Note that N must not be zero:

let slice = [1, 2, 3];
let _fail = slice.bitcoin_as_chunks::<0>(); // Fails to compile

fn bitcoin_as_chunks_mut<const N: usize>( &mut self, ) -> (&mut [[Self::Item; N]], &mut [Self::Item])

Splits up the slice into a slice of arrays and a remainder.

Note that N must not be zero:

let mut slice = [1, 2, 3];
let _fail = slice.bitcoin_as_chunks_mut::<0>(); // Fails to compile

fn get_array<const ARRAY_LEN: usize>( &self, offset: usize, ) -> Option<&[Self::Item; ARRAY_LEN]>

Tries to access a sub-array of length ARRAY_LEN at the specified offset.

Returns None in case of out-of-bounds access.

fn split_first_chunk<const ARRAY_LEN: usize>( &self, ) -> Option<(&[Self::Item; ARRAY_LEN], &[Self::Item])>

Splits the slice into an array and remainder if it’s long enough.

Returns None if the slice is shorter than ARRAY_LEN

fn split_last_chunk<const ARRAY_LEN: usize>( &self, ) -> Option<(&[Self::Item], &[Self::Item; ARRAY_LEN])>

Splits the slice into a remainder and an array if it’s long enough.

Returns None if the slice is shorter than ARRAY_LEN

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

impl<T> SliceExt for [T]

type Item = T

fn bitcoin_as_chunks<const N: usize>( &self, ) -> (&[[Self::Item; N]], &[Self::Item])

fn bitcoin_as_chunks_mut<const N: usize>( &mut self, ) -> (&mut [[Self::Item; N]], &mut [Self::Item])

fn get_array<const ARRAY_LEN: usize>( &self, offset: usize, ) -> Option<&[Self::Item; ARRAY_LEN]>

fn split_first_chunk<const ARRAY_LEN: usize>( &self, ) -> Option<(&[Self::Item; ARRAY_LEN], &[Self::Item])>

fn split_last_chunk<const ARRAY_LEN: usize>( &self, ) -> Option<(&[Self::Item], &[Self::Item; ARRAY_LEN])>

Implementors