Struct Board 

pub struct Board { /* private fields */ }

A snapshot of a board

Construct via Board::try_new, which handles both start-of-trick (use CurrentTrick::new) and mid-trick (0–3 played cards) cases. The invariants below are enforced by the constructor.

Invariants

1. remaining is a valid PartialDeal (≤13 cards per hand, pairwise disjoint).
2. Each card in the current trick is absent from every remaining hand (the “already played” invariant).
3. Uniform-size-after-restoration: putting the k = current_trick.len() table cards back into their players’ hands yields a subset where all four hands share a common size m. Equivalently, the k seats starting at current_trick.leader() (in playing order: leader, leader.lho(), …) have size m − 1 and the remaining 4 − k seats have size m.

Implementations

impl Board

pub fn try_new( remaining: PartialDeal, current_trick: CurrentTrick, ) -> Result<Self, BoardError>

Construct a mid-trick board from a pre-validated CurrentTrick and the cards remaining in each hand.

Errors

Returns a BoardError if the invariants documented on Board do not hold.

pub const fn trump(&self) -> Strain

Strain of the contract

pub const fn leader(&self) -> Seat

Seat leading the current trick

pub fn current_cards(&self) -> &[Card]

Cards already played to the current trick, in playing order

pub const fn current_trick(&self) -> &CurrentTrick

The current trick — cards played so far plus trump and leader

pub const fn remaining(&self) -> &PartialDeal

Remaining cards in each hand

Trait Implementations

impl Clone for Board

fn clone(&self) -> Board

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Board

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

Formats the value using the given formatter.

impl From<Board> for deal

fn from(board: Board) -> Self

Converts to this type from the input type.

impl Hash for Board

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 Board

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

impl StructuralPartialEq for Board