Struct das_grid::DasGrid

pub struct DasGrid<T: Copy + Clone> { /* fields omitted */ }

Stores the grid values and the cells The grid itself representation is a flatten vector which is transformed for 2D representation when called by the user

The cells are internally manage by a Vec<T>

Implementations

impl<T: Copy + Clone> DasGrid<T>

pub fn new(width: i32, height: i32, value: T) -> Self where
    T: Clone + Copy + Display, 

Creates a grid of size rows x columns with default value passed on the third parameter For example this will generate a 2x2 grid of value 1:

use DasGrid::Grid;
let grid = Grid::new(2, 2, 1);
assert!(grid.size() == 4);

pub fn set(&mut self, index: (i32, i32), value: &T) -> Result<(), OutOfGridErr> where
    T: Copy, 

Sets a given value to the position (x, y)

Be careful if the value is out of the bounds of grid it will return an error with the type of OutOfGridErr

use DasGrid::Grid;
let mut grid = Grid::new(2, 2, 1);
grid.set((0, 0), &1); // Result<(), OutOfGridErr>

pub fn get_mut(&mut self, index: (i32, i32)) -> Result<&mut T, OutOfGridErr>

Gets a give value to the position (x, y) as mutable

Be careful if the value is out of the bounds of grid it will return an error with the type of OutOfGridErr

use DasGrid::Grid;
let grid = Grid::new(2, 2, 1);
let mut v = grid.get_mut((0, 0)); // Result<&T, OutOfGridE

pub fn get(&self, index: (i32, i32)) -> Result<&T, OutOfGridErr>

Gets a give value to the position (x, y)

Be careful if the value is out of the bounds of grid it will return an error with the type of OutOfGridErr

use DasGrid::Grid;
let grid = Grid::new(2, 2, 1);
let v = grid.get((0, 0)); // Result<&T, OutOfGridErr>

pub fn mov(
    &mut self,
    index: (i32, i32),
    dest: (i32, i32)
) -> Result<(), OutOfGridErr>

Moves a given value from position (x, y) to destiny position (x, y)

Be careful if the value is out of the bounds of grid it will return an error with the type of OutOfGridErr

use DasGrid::Grid;
let mut grid = Grid::new(2, 2, 1);
grid.mov((0, 0), (1, 1)); // Result<(), OutOfGridErr>

pub fn mov_to(
    &mut self,
    index: (i32, i32),
    direction: MoveDirection
) -> Result<(), OutOfGridErr>

Moves a given value from position (x, y) to another position based on the direction

The directions can be Left, Right, Top, Down:

• DasGrid::MoveDirection::Left, translates to (-1, 0)
• DasGrid::MoveDirection::Right, translates to (1, 0)
• DasGrid::MoveDirection::Top, translates to (0, -1)
• DasGrid::MoveDirection::Down, translates to (0, 1)

Be careful if the value is out of the bounds of grid it will return an error with the type of OutOfGridErr

use DasGrid::Grid;
let mut grid = Grid::new(2, 2, 1);
grid.mov_to((0, 0), Grid::MoveDirection::Right)); // Result<(), OutOfGridErr>

pub fn size(&self) -> usize

Get the size of grid based on cells length

For instance a 10x10 grid will return the size of 100

use DasGrid::Grid;
let grid = Grid::new(2, 2, 1);
grid.size(); // Equals 4

pub fn width(&self) -> i32

The width of the grid

pub fn height(&self) -> i32

The height of the grid

pub fn enumerate(&self) -> Vec<(i32, i32)>

Returns the grid as a tuple of (x, y)

let grid = Grid::new(2, 2, 1);
for (x, y) in grid.enumerate() {
    println!("x {} y {}", x, y);
}

Trait Implementations

impl<T: Copy + Clone + Display> Debug for DasGrid<T>

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

Formats the value using the given formatter.

impl<T: Copy + Clone> Display for DasGrid<T>

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

Formats the value using the given formatter.

impl<T: Copy + Clone> Index<(i32, i32)> for DasGrid<T>

type Output = T

The returned type after indexing.

fn index(&self, index: (i32, i32)) -> &T

Performs the indexing (container[index]) operation.

impl<T: Copy + Clone> IndexMut<(i32, i32)> for DasGrid<T>

fn index_mut(&mut self, index: (i32, i32)) -> &mut T

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

impl<'a, T: Copy + Clone> IntoIterator for &'a DasGrid<T>

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: Copy + Clone> IntoIterator for &'a mut DasGrid<T>

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.