Struct Table 

pub struct Table { /* private fields */ }

A round in progress, with per-seat knowledge tracking

Table::round intentionally exposes the full position — user interfaces and loggers need it — but strategies only ever receive the Views handed to them by Table::step.

Implementations

impl Table

pub fn new(round: Round) -> Self

Wrap a freshly dealt round

The round must still be in the upcard phase: knowledge accumulated during earlier play cannot be reconstructed from a mid-game round.

The game score defaults to level (both seats at zero), so a standalone round reports game_scores of [0, 0]. Set it with Table::scores when driving a round within a game.

pub const fn scores(self, scores: [u16; 2]) -> Self

Set the running game totals, indexed by Player

Each seat’s View then reports the seat-relative game_scores, letting score-aware strategies bank a lead or gamble from behind.

pub fn deal(rules: Rules, dealer: Player, rng: &mut (impl Rng + ?Sized)) -> Self

Shuffle and deal a fresh round onto a new table

pub const fn round(&self) -> &Round

The underlying round, fully visible

pub const fn turn(&self) -> Option<Player>

The player to act, or None when the round is finished

pub const fn view(&self, seat: Player) -> View<'_>

The legally visible information for one seat

pub fn step( &mut self, strategy: &mut dyn Strategy, ) -> Result<Option<RoundResult>, EngineError>

Ask strategy — which must belong to the seat to act — for one decision and apply it

Returns the result once the round finishes, None while it continues. On the forced stock draw after both players pass the upcard, the strategy is not consulted; the draw is applied directly.

Errors

EngineError::IllegalAction when the round rejects the strategy’s choice. The table is left unchanged, so an interactive caller may retry the same decision.

pub fn play( &mut self, strategies: [&mut dyn Strategy; 2], ) -> Result<RoundResult, EngineError>

Drive the round to completion, one strategy per seat

Errors

EngineError::IllegalAction when a strategy’s choice is rejected.

Trait Implementations

impl Clone for Table

fn clone(&self) -> Table

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Table

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

Formats the value using the given formatter.