Struct Grid

pub struct Grid<T> { /* private fields */ }

A row-major 2d grid

Implementations

impl<T> Grid<T>

where T: Default,

pub fn new_with_default(width: usize, height: usize) -> Self

Create a new grid of the given size, with each cells being initialized with the default value of T

impl<T> Grid<T>

pub fn new() -> Self

Create a new empty grid

Use Self::push_row to add content

pub fn new_with_capacity(capacity: usize) -> Self

Create a new empty grid with pre-allocated capacity cells

Use Self::push_row to add content

pub fn new_with( width: usize, height: usize, init: impl FnMut(usize, usize) -> T, ) -> Self

Create a new grid of the given size, with each cells being initialized with the given function

pub fn push_row( &mut self, row: impl IntoIterator<Item = T>, ) -> Result<(), IncompatibleRowSize>

Push a row to the grid

If the grid is not empty, the row length should match the current width of the grid.

Errors

Returns IncompatibleRowSize if the grid is not empty and the length of the added row does not match the current width of the grid.

pub fn get(&self, x: usize, y: usize) -> Option<&T>

Get a reference to the cell at col x and row y

Returns None if x and y are out of bounds

pub fn get_mut(&mut self, x: usize, y: usize) -> Option<&mut T>

Get a mutable reference to the cell at col x and row y

Returns None if x and y are out of bounds

pub fn set(&mut self, x: usize, y: usize, new_value: T) -> Option<T>

Set the new value to the cell at col x and row y and return the old value.

Returns None if x and y are out of bounds

pub fn cells(&self) -> impl DoubleEndedIterator<Item = &T>

Returns an iterator over the cells

pub fn cells_mut(&mut self) -> impl DoubleEndedIterator<Item = &mut T>

Returns a mutable iterator over the cells

pub fn rows(&self) -> impl DoubleEndedIterator<Item = &[T]>

Returns an iterator over the rows

Trait Implementations

impl<T: Clone> Clone for Grid<T>

fn clone(&self) -> Grid<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Grid<T>

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

Formats the value using the given formatter.

impl<T> Default for Grid<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T: PartialEq> PartialEq for Grid<T>

fn eq(&self, other: &Grid<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: Eq> Eq for Grid<T>

impl<T> StructuralPartialEq for Grid<T>