Struct goban::rules::game::Game

pub struct Game { /* fields omitted */ }

Most important struct of the library, it’s the entry point. It represents a Game of Go.

Implementations

impl Game

pub fn goban(&self) -> &Goban

pub fn last_hash(&self) -> &u64

impl Game

pub fn passes(&self) -> u8

pub fn prisoners(&self) -> (u32, u32)

pub fn turn(&self) -> Player

pub fn rule(&self) -> Rule

pub fn handicap(&self) -> u8

impl Game

pub fn set_rule(&mut self, val: Rule) -> &mut Self

impl Game

pub fn new(size: GobanSizes, rule: Rule) -> Self

Crates a new game for playing Go

impl Game

pub fn resume(&mut self)

Resume the game when to players have passed, and want to continue.

pub fn set_komi(&mut self, komi: f32)

pub fn komi(&self) -> f32

pub fn size(&self) -> (usize, usize)

pub fn is_over(&self) -> bool

True when the game is over (two passes, or no more legals moves, Resign)

pub fn outcome(&self) -> Option<EndGame>

Returns the endgame. None if the game is not finished

pub fn pseudo_legals(&self) -> impl Iterator<Item = Point> + '_

Generate all moves on all empty intersections. Lazy.

pub fn pseudo_legals_vec(&self) -> Vec<Point>

Get all moves on all empty intersections.

pub fn legals(&self) -> impl Iterator<Item = Point> + '_

Returns a list with legals moves. from the rule specified in at the creation.

pub fn legals_by(
    &self,
    legals_rules: IllegalRules
) -> impl Iterator<Item = Point> + '_

Return a list with the legals moves. doesn’t take the rule specified in the game but take the one passed on parameter.

pub fn play(&mut self, play: Move) -> &mut Self

Method to play on the goban or pass. (0,0) is in the top left corner of the goban.

Panics

If the coordinates of the move are outside the board.

pub fn play_for_verification(&self, (x, y): Point) -> u64

This methods plays a move then return the hash of the goban simulated, used in legals for fast move simulation in Super Ko situations.

pub fn try_play(&mut self, play: Move) -> Result<&mut Self, PlayError>

Method to play but it verifies if the play is legal or not.

Errors

If the move is a suicide Move return SuicideMove If the move is a Ko Move returns Ko if point is already filled then return PointNotEmpty If the game is paused then return GamePaused

pub fn put_handicap(&mut self, points: &[Point])

Put the handicap stones on the goban. This put the turn for white but doesn’t update the komi.

pub fn calculate_score(&self) -> (f32, f32)

Calculates score. with prisoners and komi. Dependant of the rule in the game.

pub fn calculate_score_by(&self, rule: ScoreRules) -> (f32, f32)

Calculates the score by the rule passed in parameter.

pub fn will_capture(&self, point: Point) -> bool

Returns true if the stone played in that point will capture another string.

pub fn check_point(&self, point: Point) -> Option<PlayError>

Test if a point is legal or not for the current player,

pub fn check_point_by(
    &self,
    point: Point,
    illegal_rules: IllegalRules
) -> Option<PlayError>

Test if a point is legal or not by the rule passed in parameter.

pub fn check_eye(&self, _: Stone) -> bool

Detects true eyes. return true is the stone is an eye. Except for this form :

 ++
 + ++
 ++ +
   ++

This function is only used for performance checking in the rules, and not for checking is a point is really an eye !

pub fn check_ko(&self, stone: Stone) -> bool

Test if a play is ko. If the goban is in the configuration of two plays ago returns true

pub fn check_superko(&self, stone: Stone) -> bool

Rule of the super Ko, if any before configuration was already played then return true.

pub fn check_suicide(&self, stone: Stone) -> bool

Add a stone to the board an then test if the stone or stone group is dead. Returns true if the move is a suicide

pub fn display_goban(&self)

Displays the internal board.

impl Game

pub fn builder() -> GameBuilder

impl Game

pub fn from_sgf(sgf_str: &str) -> Result<Self, String>

Trait Implementations

impl Clone for Game

fn clone(&self) -> Game

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Game

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

Formats the value using the given formatter.

impl Default for Game

fn default() -> Self

Returns the “default value” for a type.