Struct sqrid::Grid

pub struct Grid<T, const WIDTH: u16, const HEIGHT: u16, const SIZE: usize>(/* private fields */);

A grid is a generic array that can be indexed by a Qa

We can also interact with specific lines with Grid::line and Grid::line_mut, or with the whole underlying array with as_ref and as_mut.

At the moment we have to provide a SIZE argument = WIDTH * HEIGHT. This value is checked at compile time, but can’t be ellided at the moment, due to rust const generics limitations.

We can use the grid_create macro to use a Qa as a source of these values.

Implementations

impl<T, const W: u16, const H: u16, const SIZE: usize> Grid<T, W, H, SIZE>

pub const SIZE: usize = SIZE

Number of elements in the grid.

pub fn repeat(item: T) -> Self

where T: Copy,

Create a grid filled with copies of the provided item

This is the fastest of the repeat_* functions, that’s why it’s the “default”.

pub fn into_inner(self) -> [T; SIZE]

“Dismantle” a Grid into the inner array; consumes self.

pub fn as_array(&self) -> &[T; SIZE]

Return a reference to the inner array

pub fn as_array_mut(&mut self) -> &mut [T; SIZE]

Return a mut reference to the inner array

pub fn line(&self, lineno: u16) -> &[T]

Return a specific grid line as a reference to a slice

pub fn line_mut(&mut self, lineno: u16) -> &mut [T]

Return a specific grid line as a mut reference to a slice

Allows quick assignment operations on whole lines.

pub fn get(&self, qa: impl Borrow<Qa<W, H>>) -> &T

Get a reference to an element of the grid.

We use get_unchecked internally, because we guarantee the validity of the Qa index on construction.

pub fn get_mut(&mut self, qa: impl Borrow<Qa<W, H>>) -> &mut T

Get a mut reference to an element of the grid.

We use get_unchecked internally, because we guarantee the validity of the Qa index on construction.

pub fn iter(&self) -> Iter<'_, T>

Returns an iterator over the grid values

pub fn iter_mut(&mut self) -> IterMut<'_, T>

Returns an iterator that allows modifying each value

pub fn iter_qa(&self) -> impl Iterator<Item = (Qa<W, H>, &T)>

Returns an iterator over the grid coordinates and values

pub fn flip_h(&mut self)

Flip all elements horizontally.

pub fn flip_v(&mut self)

Flip all elements vertically.

impl<T, const W: u16, const SIZE: usize> Grid<T, W, W, SIZE>

pub fn rotate_cw(&mut self)

Rotate all elements 90 degrees clockwise

pub fn rotate_cc(&mut self)

Rotate all elements 90 degrees counterclockwise

Trait Implementations

impl<T, const W: u16, const H: u16, const SIZE: usize> AsMut<[T; SIZE]> for Grid<T, W, H, SIZE>

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

Converts this type into a mutable reference of the (usually inferred) input type.

impl<T, const W: u16, const H: u16, const SIZE: usize> AsRef<[T; SIZE]> for Grid<T, W, H, SIZE>

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

Converts this type into a shared reference of the (usually inferred) input type.

impl<T: Clone, const WIDTH: u16, const HEIGHT: u16, const SIZE: usize> Clone for Grid<T, WIDTH, HEIGHT, SIZE>

fn clone(&self) -> Grid<T, WIDTH, HEIGHT, SIZE>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug, const WIDTH: u16, const HEIGHT: u16, const SIZE: usize> Debug for Grid<T, WIDTH, HEIGHT, SIZE>

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

Formats the value using the given formatter.

impl<T: Default, const W: u16, const H: u16, const SIZE: usize> Default for Grid<T, W, H, SIZE>

fn default() -> Self

Returns the “default value” for a type.

impl<T: Display, const W: u16, const H: u16, const SIZE: usize> Display for Grid<T, W, H, SIZE>

Pretty-printer Grid display implementation

The Display implementation of grid was made to print an ascii-like grid. It does that in one pass, and uses the padding parameter as the size to reserve for each member.

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

Formats the value using the given formatter.

impl<'a, T: 'a + Copy, const W: u16, const H: u16, const SIZE: usize> Extend<&'a (Qa<W, H>, T)> for Grid<T, W, H, SIZE>

fn extend<I>(&mut self, iter: I)

where I: IntoIterator<Item = &'a (Qa<W, H>, T)>,

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

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

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

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

Reserves capacity in a collection for the given number of additional elements.

impl<'a, T: 'a + Copy, const W: u16, const H: u16, const SIZE: usize> Extend<(Qa<W, H>, &'a T)> for Grid<T, W, H, SIZE>

fn extend<I>(&mut self, iter: I)

where I: IntoIterator<Item = (Qa<W, H>, &'a T)>,

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

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

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

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

Reserves capacity in a collection for the given number of additional elements.

impl<T, const W: u16, const H: u16, const SIZE: usize> Extend<(Qa<W, H>, T)> for Grid<T, W, H, SIZE>

fn extend<I>(&mut self, iter: I)

where I: IntoIterator<Item = (Qa<W, H>, T)>,

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

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

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

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

Reserves capacity in a collection for the given number of additional elements.

impl<'a, T: 'a + Copy + Default, const W: u16, const H: u16, const SIZE: usize> FromIterator<&'a T> for Grid<T, W, H, SIZE>

Creates a Grid from an iterator that returns references

Assumes we are getting exactly all grid elements; it panics otherwise.

fn from_iter<I>(iter: I) -> Self

where I: IntoIterator<Item = &'a T>,

Creates a value from an iterator.

impl<T: Default, const W: u16, const H: u16, const SIZE: usize> FromIterator<T> for Grid<T, W, H, SIZE>

Creates a Grid from an iterator that returns values

Assumes we are getting exactly all grid elements; it panics otherwise.

fn from_iter<I>(iter: I) -> Self

where I: IntoIterator<Item = T>,

Creates a value from an iterator.

impl<T, AQA, const W: u16, const H: u16, const SIZE: usize> Index<AQA> for Grid<T, W, H, SIZE>

where AQA: Borrow<Qa<W, H>>,

type Output = T

The returned type after indexing.

fn index(&self, aqa: AQA) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<T, AQA, const W: u16, const H: u16, const SIZE: usize> IndexMut<AQA> for Grid<T, W, H, SIZE>

where AQA: Borrow<Qa<W, H>>,

fn index_mut(&mut self, aqa: AQA) -> &mut T

Performs the mutable indexing (container[index]) operation.

impl<'a, T, const W: u16, const H: u16, const SIZE: usize> IntoIterator for &'a Grid<T, W, H, SIZE>

type Item = &'a T

The type of the elements being iterated over.

type IntoIter = Iter<'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, const W: u16, const H: u16, const SIZE: usize> IntoIterator for &'a mut Grid<T, W, H, SIZE>

type Item = &'a mut T

The type of the elements being iterated over.

type IntoIter = IterMut<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T, const W: u16, const H: u16, const SIZE: usize> IntoIterator for Grid<T, W, H, SIZE>

type Item = T

The type of the elements being iterated over.

type IntoIter = IntoIter<T, SIZE>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<Item, const W: u16, const H: u16, const WORDS: usize, const SIZE: usize> MapQa<Item, W, H, WORDS, SIZE> for Grid<Item, W, H, SIZE>

where Item: Copy,

fn new(item: Item) -> Self

Create a new MapQa with the provided value for all items

fn get(&self, qa: &Qa<W, H>) -> &Item

Get the item corresponding to the provided Qa

fn set(&mut self, qa: Qa<W, H>, item: Item)

Set the item corresponding to the provided Qa

impl<T, const W: u16, const H: u16, const SIZE: usize> Neg for Grid<T, W, H, SIZE>

where T: Neg<Output = T> + Default + Copy,

type Output = Grid<T, W, H, SIZE>

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl<T: PartialEq, const WIDTH: u16, const HEIGHT: u16, const SIZE: usize> PartialEq for Grid<T, WIDTH, HEIGHT, SIZE>

fn eq(&self, other: &Grid<T, WIDTH, HEIGHT, SIZE>) -> 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<T: Default, const W: u16, const H: u16, const SIZE: usize> TryFrom<Vec<Vec<T>>> for Grid<T, W, H, SIZE>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(vec: Vec<Vec<T>>) -> Result<Self, Self::Error>

Performs the conversion.

impl<T: Copy, const WIDTH: u16, const HEIGHT: u16, const SIZE: usize> Copy for Grid<T, WIDTH, HEIGHT, SIZE>

impl<T: Eq, const WIDTH: u16, const HEIGHT: u16, const SIZE: usize> Eq for Grid<T, WIDTH, HEIGHT, SIZE>

impl<T, const WIDTH: u16, const HEIGHT: u16, const SIZE: usize> StructuralEq for Grid<T, WIDTH, HEIGHT, SIZE>

impl<T, const WIDTH: u16, const HEIGHT: u16, const SIZE: usize> StructuralPartialEq for Grid<T, WIDTH, HEIGHT, SIZE>