Enum shakmaty::Square

#[repr(i8)]
pub enum Square {
    A1,
    B1,
    C1,
    D1,
    E1,
    F1,
    G1,
    H1,
    A2,
    B2,
    C2,
    D2,
    E2,
    F2,
    G2,
    H2,
    A3,
    B3,
    C3,
    D3,
    E3,
    F3,
    G3,
    H3,
    A4,
    B4,
    C4,
    D4,
    E4,
    F4,
    G4,
    H4,
    A5,
    B5,
    C5,
    D5,
    E5,
    F5,
    G5,
    H5,
    A6,
    B6,
    C6,
    D6,
    E6,
    F6,
    G6,
    H6,
    A7,
    B7,
    C7,
    D7,
    E7,
    F7,
    G7,
    H7,
    A8,
    B8,
    C8,
    D8,
    E8,
    F8,
    G8,
    H8,
}

A square index.

Variants

A1B1C1D1E1F1G1H1A2B2C2D2E2F2G2H2A3B3C3D3E3F3G3H3A4B4C4D4E4F4G4H4A5B5C5D5E5F5G5H5A6B6C6D6E6F6G6H6A7B7C7D7E7F7G7H7A8B8C8D8E8F8G8H8

Methods

impl Square

pub fn new(index: i8) -> Square

Creates a Square from an integer index.

Panics

Panics if the index is not in the range 0..=63.

pub fn from_index(index: i8) -> Option<Square>

Tries to create a Square from an integer index in the range 0..=63.

pub unsafe fn from_index_unchecked(index: i8) -> Square

Creates a Square from an integer index.

Unsafety

It is the callers responsibility to ensure it is in the range 0..=63.

pub fn from_coords(file: i8, rank: i8) -> Option<Square>

Tries to create a square from zero-based file and rank indexes.

pub unsafe fn from_coords_unchecked(file: i8, rank: i8) -> Square

Creates a Square from zero-based file and rank indexes.

Unsafety

It is the callers responsibility to ensure that file and rank are in the range 0..=7.

pub fn from_ascii(s: &[u8]) -> Result<Square, InvalidSquareName>

Parses a square name.

Errors

Returns InvalidSquareName if the input is not a valid square name in lowercase ASCII characters.

Example

use shakmaty::Square;

let sq = Square::from_ascii(b"a5")?;
assert_eq!(sq, Square::A5);

pub fn file(self) -> i8

pub fn file_char(self) -> char

pub fn rank(self) -> i8

pub fn rank_char(self) -> char

pub fn offset(self, delta: i8) -> Option<Square>

pub fn flip_horizontal(self) -> Square

Flip the square horizontally.

use shakmaty::Square;

assert_eq!(Square::H1.flip_horizontal(), Square::A1);
assert_eq!(Square::D3.flip_horizontal(), Square::E3);

pub fn flip_vertical(self) -> Square

Flip the square vertically.

use shakmaty::Square;

assert_eq!(Square::A8.flip_vertical(), Square::A1);
assert_eq!(Square::D3.flip_vertical(), Square::D6);

pub fn flip_diagonal(self) -> Square

Flip at the a1-h8 diagonal by swapping file and rank.

use shakmaty::Square;

assert_eq!(Square::A1.flip_diagonal(), Square::A1);
assert_eq!(Square::A3.flip_diagonal(), Square::C1);

pub fn is_light(self) -> bool

Tests is the square is a light square.

use shakmaty::Square;

assert!(Square::D1.is_light());
assert!(!Square::D8.is_light());

pub fn is_dark(self) -> bool

Tests is the square is a dark square.

use shakmaty::Square;

assert!(Square::E1.is_dark());
assert!(!Square::E8.is_dark());

pub fn distance(self, other: Square) -> i8

The distance between the two squares, i.e. the number of king steps to get from one square to the other.

use shakmaty::Square;

assert_eq!(Square::A2.distance(Square::B5), 3);

pub fn combine(self, rank: Square) -> Square

Combines two squares, taking the file from the first and the rank from the second.

use shakmaty::Square;

assert_eq!(Square::D3.combine(Square::F5), Square::D5);

Trait Implementations

impl Copy for Square

impl Clone for Square

fn clone(&self) -> Square

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Eq for Square

impl PartialEq for Square

fn eq(&self, other: &Square) -> 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 Ord for Square

fn cmp(&self, other: &Square) -> Ordering

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

impl PartialOrd for Square

fn partial_cmp(&self, other: &Square) -> 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 Hash for Square

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,

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

impl From<Square> for u8

fn from(sq: Square) -> u8

Performs the conversion.

impl From<Square> for i8

fn from(sq: Square) -> i8

Performs the conversion.

impl From<Square> for u16

fn from(sq: Square) -> u16

Performs the conversion.

impl From<Square> for i16

fn from(sq: Square) -> i16

Performs the conversion.

impl From<Square> for u32

fn from(sq: Square) -> u32

Performs the conversion.

impl From<Square> for i32

fn from(sq: Square) -> i32

Performs the conversion.

impl From<Square> for u64

fn from(sq: Square) -> u64

Performs the conversion.

impl From<Square> for i64

fn from(sq: Square) -> i64

Performs the conversion.

impl From<Square> for u128

fn from(sq: Square) -> u128

Performs the conversion.

impl From<Square> for i128

fn from(sq: Square) -> i128

Performs the conversion.

impl From<Square> for usize

fn from(sq: Square) -> usize

Performs the conversion.

impl From<Square> for isize

fn from(sq: Square) -> isize

Performs the conversion.

impl Sub for Square

type Output = i8

The resulting type after applying the - operator.

fn sub(self, other: Square) -> i8

Performs the - operation.

impl FromStr for Square

type Err = InvalidSquareName

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Square, InvalidSquareName>

Parses a string s to return a value of this type.

impl Display for Square

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

Formats the value using the given formatter.

impl Debug for Square

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

Formats the value using the given formatter.

impl From<Square> for Bitboard

Important traits for Bitboard

impl Iterator for Bitboard type Item = Square;

fn from(sq: Square) -> Bitboard

Performs the conversion.

impl FromIterator<Square> for Bitboard

fn from_iter<T>(iter: T) -> Self where     T: IntoIterator<Item = Square>,

Creates a value from an iterator.

impl Extend<Square> for Bitboard

fn extend<T: IntoIterator<Item = Square>>(&mut self, iter: T)

Extends a collection with the contents of an iterator.