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]

Methods

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

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.

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.

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.

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.

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.

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.

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

Extracts a slice containing the entire array.

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

Extracts a mutable slice containing the entire array.

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.

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>, 

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>, 

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

Trait Implementations

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: 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.

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: Clone, N> Clone for GenericArray<T, N> where
    N: ArrayLength<T>, 

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

Returns a copy of the value.

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: PartialEq, N> PartialEq 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 ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

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

impl<T: PartialOrd, N> PartialOrd 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.

fn lt(&self, other: &Rhs) -> bool

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

fn le(&self, other: &Rhs) -> bool

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

fn gt(&self, other: &Rhs) -> bool

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

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: 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.

fn max(self, other: Self) -> Self

🔬 This is a nightly-only experimental API. (ord_max_min)

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

🔬 This is a nightly-only experimental API. (ord_max_min)

Compares and returns the minimum of two values.

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, 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, N> AsRef<[T]> for GenericArray<T, N> where
    N: ArrayLength<T>, 

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

Performs the conversion.

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: 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].

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

Feeds a slice of this type into the given [Hasher].

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

fn from(arr: [T; 1]) -> 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; 3]> for GenericArray<T, U3>

fn from(arr: [T; 3]) -> 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> 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; 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; 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, 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, 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, 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.