Class Hand

java.lang.Object

Hand

public class Hand
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
Hand() Create a hand that is initially empty.

Method Summary

Modifier and Type	Method and Description
void	addCard(Card c) Add a card to the hand.
void	clear() Remove all cards from the hand, leaving it empty.
Card	getCard(int position) Gets the card in a specified position in the hand.
int	getCardCount() Returns the number of cards in the hand.
void	removeCard(Card c) Remove a card from the hand, if present.
void	removeCard(int position) Remove the coard in a specified position from the hand.
void	sortBySuit() Sorts the cards in the hand so that cards of the same suit are grouped together, and within a suit the cards are sorted by value.
void	sortByValue() Sorts the cards in the hand so that cards are sorted into order of increasing value.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Hand

public Hand()

Create a hand that is initially empty.

Method Detail

clear

public void clear()

Remove all cards from the hand, leaving it empty.

addCard

public void addCard(Card c)

Add a card to the hand. It is added at the end of the current hand.

Parameters:

c - the non-null card to be added.

Throws:

java.lang.NullPointerException - if the parameter c is null.

removeCard

public void removeCard(Card c)

Remove a card from the hand, if present.

Parameters:

c - the card to be removed. If c is null or if the card is not in the hand, then nothing is done.

removeCard

public void removeCard(int position)

Remove the coard in a specified position from the hand.

Parameters:

position - the position of the card that is to be removed, where positions are starting from zero.

Throws:

java.lang.IllegalArgumentException - if the position does not exist in the hand, that is if the position is less than 0 or greater than or equal to the number of cards in the hand.

getCardCount

public int getCardCount()

Returns the number of cards in the hand.

getCard

public Card getCard(int position)

Gets the card in a specified position in the hand. (Note that this card is not removed from the hand!)

Parameters:

position - the position of the card that is to be returned

Throws:

java.lang.IllegalArgumentException - if position does not exist in the hand

sortBySuit

public void sortBySuit()

Sorts the cards in the hand so that cards of the same suit are grouped together, and within a suit the cards are sorted by value. Note that aces are considered to have the lowest value, 1.

sortByValue

public void sortByValue()

Sorts the cards in the hand so that cards are sorted into order of increasing value. Cards with the same value are sorted by suit. Note that aces are considered to have the lowest value, 1.