Trait GenericSequence

Source

pub unsafe trait GenericSequence<T>: Sized + IntoIterator {
    type Length: ArrayLength;
    type Sequence: GenericSequence<T, Length = Self::Length> + FromIterator<T>;

    // Required method
    fn generate<F>(f: F) -> Self::Sequence
       where F: FnMut(usize) -> T;

    // Provided method
    fn repeat(value: T) -> Self::Sequence
       where T: Clone { ... }
}

Expand description

Defines some sequence with an associated length and iteration capabilities.

This is useful for passing N-length generic arrays as generics.

§Safety

Care must be taken when implementing such that methods are safe.

Lengths must match, and element drop on panic must be handled.

Required Associated Types§

Source

type Length: ArrayLength

GenericArray associated length

Source

type Sequence: GenericSequence<T, Length = Self::Length> + FromIterator<T>

Owned sequence type used in conjunction with reference implementations of GenericSequence

Required Methods§

Source

fn generate<F>(f: F) -> Self::Sequence
where F: FnMut(usize) -> T,

Initializes a new sequence instance using the given function.

If the generator function panics while initializing the sequence, any already initialized elements will be dropped.

Provided Methods§

Source

fn repeat(value: T) -> Self::Sequence
where T: Clone,

Initializes a new sequence instance by repeating the given value.

Clones the value for all but the last element, taking ownership of the original value for the last.

This is semantically equivalent to FromIterator::from_iter(core::iter::repeat_n(value, N::USIZE)) but available on older Rust versions. repeat_n was stabilized in Rust 1.82.0