Struct generic_array::GenericArray

pub struct GenericArray<T, U: ArrayLength<T>> { /* fields omitted */ }

Struct representing a generic array - GenericArray<T, N> works like [T; N]

Implementations

impl<T, N> GenericArray<T, N> where
    N: ArrayLength<T>, 

pub fn generate<F>(f: F) -> GenericArray<T, N> where
    F: Fn(usize) -> T, 

Initializes a new GenericArray instance using the given function.

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

pub fn map_slice<S, F: Fn(&S) -> T>(s: &[S], f: F) -> GenericArray<T, N>

Map a function over a slice to a GenericArray.

The length of the slice must be equal to the length of the array.

pub fn map<U, F>(self, f: F) -> GenericArray<U, N> where
    F: Fn(T) -> U,
    N: ArrayLength<U>, 

Maps a GenericArray to another GenericArray.

If the mapping function panics, any already initialized elements in the new array will be dropped, AND any unused elements in the source array will also be dropped.

pub fn map_ref<U, F>(&self, f: F) -> GenericArray<U, N> where
    F: Fn(&T) -> U,
    N: ArrayLength<U>, 

Maps a GenericArray to another GenericArray by reference.

If the mapping function panics, any already initialized elements will be dropped.

pub fn zip<B, U, F>(self, rhs: GenericArray<B, N>, f: F) -> GenericArray<U, N> where
    F: Fn(T, B) -> U,
    N: ArrayLength<B> + ArrayLength<U>, 

Combines two GenericArray instances and iterates through both of them, initializing a new GenericArray with the result of the zipped mapping function.

If the mapping function panics, any already initialized elements in the new array will be dropped, AND any unused elements in the source arrays will also be dropped.

pub fn zip_ref<B, U, F>(
    &self,
    rhs: &GenericArray<B, N>,
    f: F
) -> GenericArray<U, N> where
    F: Fn(&T, &B) -> U,
    N: ArrayLength<B> + ArrayLength<U>, 

Combines two GenericArray instances and iterates through both of them by reference, initializing a new GenericArray with the result of the zipped mapping function.

If the mapping function panics, any already initialized elements will be dropped.

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

Extracts a slice containing the entire array.

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

Extracts a mutable slice containing the entire array.

pub fn from_slice(slice: &[T]) -> &GenericArray<T, N>

Converts slice to a generic array reference with inferred length;

Length of the slice must be equal to the length of the array.

pub fn from_mut_slice(slice: &mut [T]) -> &mut GenericArray<T, N>

Converts mutable slice to a mutable generic array reference

Length of the slice must be equal to the length of the array.

impl<T: Clone, N> GenericArray<T, N> where
    N: ArrayLength<T>, 

pub fn clone_from_slice(list: &[T]) -> GenericArray<T, N>

Construct a GenericArray from a slice by cloning its content

Length of the slice must be equal to the length of the array

impl<T, N> GenericArray<T, N> where
    N: ArrayLength<T>, 

pub fn from_exact_iter<I>(iter: I) -> Option<Self> where
    I: IntoIterator<Item = T>,
    <I as IntoIterator>::IntoIter: ExactSizeIterator, 

Trait Implementations

impl<T, N> AsMut<[T]> for GenericArray<T, N> where
    N: ArrayLength<T>, 

fn as_mut(&mut self) -> &mut [T]

Performs the conversion.

impl<T, N> AsRef<[T]> for GenericArray<T, N> where
    N: ArrayLength<T>, 

fn as_ref(&self) -> &[T]

Performs the conversion.

impl<T, N> Borrow<[T]> for GenericArray<T, N> where
    N: ArrayLength<T>, 

fn borrow(&self) -> &[T]

Immutably borrows from an owned value.

impl<T, N> BorrowMut<[T]> for GenericArray<T, N> where
    N: ArrayLength<T>, 

fn borrow_mut(&mut self) -> &mut [T]

Mutably borrows from an owned value.

impl<T: Clone, N> Clone for GenericArray<T, N> where
    N: ArrayLength<T>, 

fn clone(&self) -> GenericArray<T, N>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Copy, N> Copy for GenericArray<T, N> where
    N: ArrayLength<T>,
    N::ArrayType: Copy, 

impl<T: Debug, N> Debug for GenericArray<T, N> where
    N: ArrayLength<T>, 

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

Formats the value using the given formatter.

impl<T: Default, N> Default for GenericArray<T, N> where
    N: ArrayLength<T>, 

fn default() -> Self

Returns the “default value” for a type.

impl<T, N> Deref for GenericArray<T, N> where
    N: ArrayLength<T>, 

type Target = [T]

The resulting type after dereferencing.

fn deref(&self) -> &[T]

Dereferences the value.

impl<T, N> DerefMut for GenericArray<T, N> where
    N: ArrayLength<T>, 

fn deref_mut(&mut self) -> &mut [T]

Mutably dereferences the value.

impl<T: Eq, N> Eq for GenericArray<T, N> where
    N: ArrayLength<T>, 

impl<T> From<[T; 1]> for GenericArray<T, U1>

fn from(arr: [T; 1]) -> Self

Performs the conversion.

impl<T> From<[T; 10]> for GenericArray<T, U10>

fn from(arr: [T; 10]) -> Self

Performs the conversion.

impl<T> From<[T; 11]> for GenericArray<T, U11>

fn from(arr: [T; 11]) -> Self

Performs the conversion.

impl<T> From<[T; 12]> for GenericArray<T, U12>

fn from(arr: [T; 12]) -> Self

Performs the conversion.

impl<T> From<[T; 13]> for GenericArray<T, U13>

fn from(arr: [T; 13]) -> Self

Performs the conversion.

impl<T> From<[T; 14]> for GenericArray<T, U14>

fn from(arr: [T; 14]) -> Self

Performs the conversion.

impl<T> From<[T; 15]> for GenericArray<T, U15>

fn from(arr: [T; 15]) -> Self

Performs the conversion.

impl<T> From<[T; 16]> for GenericArray<T, U16>

fn from(arr: [T; 16]) -> Self

Performs the conversion.

impl<T> From<[T; 17]> for GenericArray<T, U17>

fn from(arr: [T; 17]) -> Self

Performs the conversion.

impl<T> From<[T; 18]> for GenericArray<T, U18>

fn from(arr: [T; 18]) -> Self

Performs the conversion.

impl<T> From<[T; 19]> for GenericArray<T, U19>

fn from(arr: [T; 19]) -> Self

Performs the conversion.

impl<T> From<[T; 2]> for GenericArray<T, U2>

fn from(arr: [T; 2]) -> Self

Performs the conversion.

impl<T> From<[T; 20]> for GenericArray<T, U20>

fn from(arr: [T; 20]) -> Self

Performs the conversion.

impl<T> From<[T; 21]> for GenericArray<T, U21>

fn from(arr: [T; 21]) -> Self

Performs the conversion.

impl<T> From<[T; 22]> for GenericArray<T, U22>

fn from(arr: [T; 22]) -> Self

Performs the conversion.

impl<T> From<[T; 23]> for GenericArray<T, U23>

fn from(arr: [T; 23]) -> Self

Performs the conversion.

impl<T> From<[T; 24]> for GenericArray<T, U24>

fn from(arr: [T; 24]) -> Self

Performs the conversion.

impl<T> From<[T; 25]> for GenericArray<T, U25>

fn from(arr: [T; 25]) -> Self

Performs the conversion.

impl<T> From<[T; 26]> for GenericArray<T, U26>

fn from(arr: [T; 26]) -> Self

Performs the conversion.

impl<T> From<[T; 27]> for GenericArray<T, U27>

fn from(arr: [T; 27]) -> Self

Performs the conversion.

impl<T> From<[T; 28]> for GenericArray<T, U28>

fn from(arr: [T; 28]) -> Self

Performs the conversion.

impl<T> From<[T; 29]> for GenericArray<T, U29>

fn from(arr: [T; 29]) -> Self

Performs the conversion.

impl<T> From<[T; 3]> for GenericArray<T, U3>

fn from(arr: [T; 3]) -> Self

Performs the conversion.

impl<T> From<[T; 30]> for GenericArray<T, U30>

fn from(arr: [T; 30]) -> Self

Performs the conversion.

impl<T> From<[T; 31]> for GenericArray<T, U31>

fn from(arr: [T; 31]) -> Self

Performs the conversion.

impl<T> From<[T; 32]> for GenericArray<T, U32>

fn from(arr: [T; 32]) -> Self

Performs the conversion.

impl<T> From<[T; 4]> for GenericArray<T, U4>

fn from(arr: [T; 4]) -> Self

Performs the conversion.

impl<T> From<[T; 5]> for GenericArray<T, U5>

fn from(arr: [T; 5]) -> Self

Performs the conversion.

impl<T> From<[T; 6]> for GenericArray<T, U6>

fn from(arr: [T; 6]) -> Self

Performs the conversion.

impl<T> From<[T; 7]> for GenericArray<T, U7>

fn from(arr: [T; 7]) -> Self

Performs the conversion.

impl<T> From<[T; 8]> for GenericArray<T, U8>

fn from(arr: [T; 8]) -> Self

Performs the conversion.

impl<T> From<[T; 9]> for GenericArray<T, U9>

fn from(arr: [T; 9]) -> Self

Performs the conversion.

impl<T, N> FromIterator<T> for GenericArray<T, N> where
    N: ArrayLength<T>,
    T: Default, 

fn from_iter<I>(iter: I) -> GenericArray<T, N> where
    I: IntoIterator<Item = T>, 

Creates a value from an iterator.

impl<T: Hash, N> Hash for GenericArray<T, N> where
    N: ArrayLength<T>, 

fn hash<H>(&self, state: &mut H) where
    H: Hasher, 

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl<T, N> IntoIterator for GenericArray<T, N> where
    N: ArrayLength<T>, 

type Item = T

The type of the elements being iterated over.

type IntoIter = GenericArrayIter<T, N>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T: ArrayLength<u8>> LowerHex for GenericArray<u8, T> where
    T: Add<T>,
    <T as Add<T>>::Output: ArrayLength<u8>, 

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

Formats the value using the given formatter.

impl<T: Ord, N> Ord for GenericArray<T, N> where
    N: ArrayLength<T>, 

fn cmp(&self, other: &GenericArray<T, N>) -> Ordering

This method returns an Ordering between self and other.

#[must_use]pub fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]pub fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]pub fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl<T: PartialEq, N> PartialEq<GenericArray<T, N>> for GenericArray<T, N> where
    N: ArrayLength<T>, 

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: PartialOrd, N> PartialOrd<GenericArray<T, N>> for GenericArray<T, N> where
    N: ArrayLength<T>, 

fn partial_cmp(&self, other: &GenericArray<T, N>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]pub fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]pub fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T: ArrayLength<u8>> UpperHex for GenericArray<u8, T> where
    T: Add<T>,
    <T as Add<T>>::Output: ArrayLength<u8>, 

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

Formats the value using the given formatter.