Struct ConnectFour

pub struct ConnectFour { /* private fields */ }

Implementation of the Connect Four game. The board is implemented as to 64 bit masks. It allows for fast checking of winning conditions and legal moves. Apart from being able to play connect four, this type also features some utility functions which can help with implementations of heuristics and solvers.

Implementations

impl ConnectFour

pub fn new() -> ConnectFour

Create an empty board

pub fn play(&mut self, column: Column) -> bool

Inserts a stone for the current player. true if move has been legal

pub fn is_legal_move(&self, column: Column) -> bool

true if the column is not full.

pub fn from_move_list(move_list: &str) -> ConnectFour

Create a game state from a sequence of moves. Each move represented as a number from 1 to 7 standing for the column the player put in their stones.

pub fn print_to(&self, out: impl Write) -> Result<()>

Prints out a text representation of a board to out

pub fn legal_moves(&self) -> impl Iterator<Item = Column> + use<'_>

pub fn stones(&self) -> u8

Number of stones in the board

pub fn is_victory(&self) -> bool

true if the player which did insert the last stone has won the game.

pub fn encode(&self) -> u64

Uses the first 49 Bits to uniquely encode the board.

pub fn can_win_in_next_move(&self) -> bool

true if the current player has winning moves available

pub fn is_over(&self) -> bool

true if game has a winner or is a draw.

pub fn non_loosing_moves(&self) -> impl Iterator<Item = Column>

List all moves, which prevent the opponet from winning immediately. Only gives valid results if Self::can_win_in_next_move is false.

Trait Implementations

impl Clone for ConnectFour

fn clone(&self) -> ConnectFour

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ConnectFour

fn default() -> ConnectFour

Returns the “default value” for a type.

impl Display for ConnectFour

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

Formats the value using the given formatter.

impl Hash for ConnectFour

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ConnectFour

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

impl Eq for ConnectFour

impl StructuralPartialEq for ConnectFour