Struct toodee::TooDeeView

pub struct TooDeeView<'a, T> { /* private fields */ }

Provides a read-only view (or subset) of a TooDee array.

Implementations

impl<'a, T> TooDeeView<'a, T>

pub fn new(num_cols: usize, num_rows: usize, data: &'a [T]) -> TooDeeView<'a, T>

Create a new TooDeeViewMut using the provided slice reference.

Panics

Panics if one of the dimensions is zero but the other is non-zero. This is to enforce the rule that empty arrays have no dimensions.

Panics if the slice’s length is not sufficient to represent the desired array dimensions.

Panics if num_cols * num_rows overflows.

Examples

use toodee::TooDeeView;
let data = vec![0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11];
let view = TooDeeView::new(4, 3, &data);

Trait Implementations

impl<'a, T: Clone> Clone for TooDeeView<'a, T>

fn clone(&self) -> TooDeeView<'a, T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for TooDeeView<'_, T>where T: Debug,

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

Formats the value using the given formatter.

impl<T> From<TooDeeView<'_, T>> for TooDee<T>where T: Clone,

fn from(view: TooDeeView<'_, T>) -> Self

Converts to this type from the input type.

impl<'a, T> From<TooDeeViewMut<'a, T>> for TooDeeView<'a, T>

fn from(v: TooDeeViewMut<'a, T>) -> TooDeeView<'a, T>

Converts to this type from the input type.

impl<'a, T: Hash> Hash for TooDeeView<'a, T>

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl<'a, T> Index<(usize, usize)> for TooDeeView<'a, T>

type Output = T

The returned type after indexing.

fn index(&self, coord: Coordinate) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<'a, T> Index<usize> for TooDeeView<'a, T>

type Output = [T]

The returned type after indexing.

fn index(&self, row: usize) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<'a, T> IntoIterator for &'a TooDeeView<'a, T>

type Item = &'a T

The type of the elements being iterated over.

type IntoIter = FlattenExact<Rows<'a, T>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, T: PartialEq> PartialEq<TooDeeView<'a, T>> for TooDeeView<'a, T>

fn eq(&self, other: &TooDeeView<'a, T>) -> 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 !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for TooDeeView<'_, u32>

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>where S: Serializer,

Serialize this value into the given Serde serializer.

impl<'a, T> TooDeeOps<T> for TooDeeView<'a, T>

unsafe fn get_unchecked_row(&self, row: usize) -> &[T]

Examples

use toodee::{TooDee,TooDeeOps,TooDeeOpsMut};
unsafe {
    let toodee : TooDee<u32> = TooDee::new(10, 5);
    let view = toodee.view((0,0), (10,5));
    let row = view.get_unchecked_row(3);
    assert_eq!(row.len(), 10);
}

unsafe fn get_unchecked(&self, coord: Coordinate) -> &T

Examples

use toodee::{TooDee,TooDeeOps,TooDeeOpsMut};
let toodee : TooDee<u32> = TooDee::new(10, 5);
let view = toodee.view((0,0), (10,5));
unsafe {
    assert_eq!(*view.get_unchecked((1,3)), 0);
}

fn num_cols(&self) -> usize

The number of columns in the area represented by this object.

fn num_rows(&self) -> usize

The number of rows in the area represented by this object.

fn view(&self, start: Coordinate, end: Coordinate) -> TooDeeView<'_, T>

Returns a view (or subset) of the current area based on the coordinates provided.

fn rows(&self) -> Rows<'_, T>

Returns an iterator of slices, where each slice represents an entire row.

fn col(&self, col: usize) -> Col<'_, T>

Returns an iterator over a single column. Note that the Col iterator is indexable.

fn size(&self) -> (usize, usize)

Returns the size/dimensions of the current object.

fn is_empty(&self) -> bool

Returns true if the array contains no elements.

fn cells(&self) -> Cells<'_, T>

Returns an iterator that traverses all cells within the area.

impl<'a, T: Copy> Copy for TooDeeView<'a, T>

impl<'a, T: Eq> Eq for TooDeeView<'a, T>

impl<'a, T> StructuralEq for TooDeeView<'a, T>

impl<'a, T> StructuralPartialEq for TooDeeView<'a, T>