Enum pgn_reader::San

pub enum San {
    Normal {
        role: Role,
        file: Option<i8>,
        rank: Option<i8>,
        capture: bool,
        to: Square,
        promotion: Option<Role>,
    },
    Castle(CastlingSide),
    Put {
        role: Role,
        to: Square,
    },
    Null,
}

A move in Standard Algebraic Notation.

Variants

Normal

Fields of Normal

role: Role
file: Option<i8>
rank: Option<i8>
capture: bool
to: Square
promotion: Option<Role>

Castle(CastlingSide)Put

Fields of Put

role: Role
to: Square

Null

Methods

impl San

pub fn from_bytes(san: &[u8]) -> Result<San, InvalidSan>

Parses a SAN. Ignores a possible check or checkmate suffix.

Errors

Returns InvalidSan if san is not syntactically valid.

pub fn to_move<P>(&self, pos: &P) -> Result<Move, SanError> where
    P: Position, 

Tries to convert the San to a legal move in the context of a position.

Errors

Returns SanError if there is no matching legal move.

pub fn matches(&self, m: &Move) -> bool

Test if the San can match the Move (in any position).

Examples

use shakmaty::{Square, Role, Move};
use shakmaty::san::San;

let m = Move::Normal {
    role: Role::Knight,
    from: Square::G1,
    to: Square::F3,
    capture: None,
    promotion: None,
};

let nf3 = San::from_bytes(b"Nf3")?;
assert!(nf3.matches(&m));

let ng1f3 = San::from_bytes(b"Ng1f3")?;
assert!(ng1f3.matches(&m));

// capture does not match
let nxf3 = San::from_bytes(b"Nxf3")?;
assert!(!nxf3.matches(&m));

// other file does not match
let nef3 = San::from_bytes(b"Nef3")?;
assert!(!nef3.matches(&m));

Trait Implementations

impl FromStr for San

type Err = InvalidSan

The associated error which can be returned from parsing.

fn from_str(san: &str) -> Result<San, InvalidSan>

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

impl PartialEq<San> for San

fn eq(&self, __arg_0: &San) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, __arg_0: &San) -> bool

This method tests for !=.

impl Clone for San

fn clone(&self) -> San

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Display for San

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

Formats the value using the given formatter.

impl Eq for San

impl Debug for San

fn fmt(&self, __arg_0: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.