Struct Builder 

pub struct Builder(/* private fields */);

A loose deal builder — any combination of four hands, no invariants

Use Builder to construct a deal incrementally. Convert it into a PartialDeal or FullDeal (via the inherent build_partial / build_full methods, or via TryFrom) once the hands are finalized. Builder is the only deal type that exposes IndexMut for in-place mutation.

Implementations

impl Builder

pub const fn new() -> Self

Construct an empty builder — all four hands empty

pub const fn north(self, hand: Hand) -> Self

Set the hand at Seat::North

pub const fn east(self, hand: Hand) -> Self

Set the hand at Seat::East

pub const fn south(self, hand: Hand) -> Self

Set the hand at Seat::South

pub const fn west(self, hand: Hand) -> Self

Set the hand at Seat::West

pub fn build_partial(self) -> Result<PartialDeal, Self>

Try to convert this builder into a PartialDeal, validating that each hand has at most 13 cards and the hands are pairwise disjoint. On failure the input is returned unchanged as the error.

Errors

Returns self unchanged if the builder is not a valid subset.

pub fn build_full(self) -> Result<FullDeal, Self>

Try to convert this builder into a FullDeal, validating that each hand has exactly 13 cards and the hands are pairwise disjoint. On failure the input is returned unchanged as the error.

Errors

Returns self unchanged if the builder is not a valid full deal.

Trait Implementations

impl Clone for Builder

fn clone(&self) -> Builder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Builder

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

Formats the value using the given formatter.

impl Default for Builder

fn default() -> Builder

Returns the “default value” for a type.

impl From<FullDeal> for Builder

fn from(deal: FullDeal) -> Self

Converts to this type from the input type.

impl From<PartialDeal> for Builder

fn from(subset: PartialDeal) -> Self

Converts to this type from the input type.

impl Hash for Builder

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 Index<Seat> for Builder

type Output = Hand

The returned type after indexing.

fn index(&self, seat: Seat) -> &Hand

Performs the indexing (container[index]) operation.

impl IndexMut<Seat> for Builder

fn index_mut(&mut self, seat: Seat) -> &mut Hand

Performs the mutable indexing (container[index]) operation.

impl IntoIterator for Builder

type Item = Hand

The type of the elements being iterated over.

type IntoIter = IntoIter<Hand, 4>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for Builder

fn eq(&self, other: &Builder) -> 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 TryFrom<Builder> for FullDeal

type Error = Builder

The type returned in the event of a conversion error.

fn try_from(builder: Builder) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Builder> for PartialDeal

type Error = Builder

The type returned in the event of a conversion error.

fn try_from(builder: Builder) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for Builder

impl Eq for Builder

impl StructuralPartialEq for Builder