Struct Hand 

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

A hand of playing cards

Implementations

impl Hand

pub const EMPTY: Self

The empty hand

pub const ALL: Self

The hand containing all 52 cards

pub const fn to_bits(self) -> u64

As a bitset of cards

pub const fn from_bits_retain(bits: u64) -> Self

Create a hand from a bitset of cards, retaining invalid cards

pub const fn contains_unknown_bits(self) -> bool

Whether the hand contains an invalid card

pub const fn from_bits(bits: u64) -> Option<Self>

Create a hand from a bitset of cards, checking for invalid cards

pub const fn from_bits_truncate(bits: u64) -> Self

Create a hand from a bitset of cards, removing invalid cards

pub const fn new( clubs: Holding, diamonds: Holding, hearts: Holding, spades: Holding, ) -> Self

Create a hand from four holdings in suit order (clubs, diamonds, hearts, spades)

pub const fn len(self) -> usize

The number of cards in the hand

pub const fn is_empty(self) -> bool

Whether the hand is empty

pub fn contains(self, card: Card) -> bool

Whether the hand contains a card

pub fn insert(&mut self, card: Card) -> bool

Insert a card into the hand, returning whether it was newly inserted

pub fn remove(&mut self, card: Card) -> bool

Remove a card from the hand, returning whether it was present

pub fn toggle(&mut self, card: Card) -> bool

Toggle a card in the hand, returning whether it is now present

pub fn set(&mut self, card: Card, condition: bool)

Conditionally insert/remove a card from the hand

pub const fn iter(self) -> HandIter

Iterate over the cards in the hand

Trait Implementations

impl BitAnd for Hand

type Output = Hand

The resulting type after applying the & operator.

fn bitand(self, rhs: Self) -> Self

Performs the & operation.

impl BitAndAssign for Hand

fn bitand_assign(&mut self, rhs: Self)

Performs the &= operation.

impl BitOr for Hand

type Output = Hand

The resulting type after applying the | operator.

fn bitor(self, rhs: Self) -> Self

Performs the | operation.

impl BitOrAssign for Hand

fn bitor_assign(&mut self, rhs: Self)

Performs the |= operation.

impl BitXor for Hand

type Output = Hand

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: Self) -> Self

Performs the ^ operation.

impl BitXorAssign for Hand

fn bitxor_assign(&mut self, rhs: Self)

Performs the ^= operation.

impl Clone for Hand

fn clone(&self) -> Hand

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Hand

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

Formats the value using the given formatter.

impl Default for Hand

fn default() -> Hand

Returns the “default value” for a type.

impl Display for Hand

PBN-compatible display of a hand

This implementation ignores formatting flags for simplicity and speed.

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

Formats the value using the given formatter.

impl FromIterator<Card> for Hand

fn from_iter<I: IntoIterator<Item = Card>>(iter: I) -> Self

Creates a value from an iterator.

impl FromStr for Hand

type Err = ParseHandError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Hand

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<Suit> for Hand

type Output = Holding

The returned type after indexing.

fn index(&self, suit: Suit) -> &Holding

Performs the indexing (container[index]) operation.

impl IndexMut<Suit> for Hand

fn index_mut(&mut self, suit: Suit) -> &mut Holding

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

impl IntoIterator for Hand

type Item = Card

The type of the elements being iterated over.

type IntoIter = HandIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> HandIter

Creates an iterator from a value.

impl Not for Hand

type Output = Hand

The resulting type after applying the ! operator.

fn not(self) -> Self

Performs the unary ! operation.

impl PartialEq for Hand

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

type Output = Hand

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self

Performs the - operation.

impl SubAssign for Hand

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl Copy for Hand

impl Eq for Hand

impl StructuralPartialEq for Hand