Class CardStack

java.lang.Object

CardStack

Direct Known Subclasses:

Cascade, Cell, Deck, Foundation

public class CardStack
extends java.lang.Object

CardStack - a superclass of all Card stacks, embodying basic functionality, yet modifiable via class extension. The toString method represents a CardStack as a comma-and-space-separated list of Card Strings.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Stack<Card>	stack

Constructor Summary

Constructors

Constructor and Description
CardStack()

Method Summary

Modifier and Type	Method and Description
void	addCard(Card card) Add the given card to the top of the stack.
boolean	canPlayFrom() Return whether or not a card may be removed from this stack.
Card	getTopCard() Return the top card (or null if empty).
boolean	isEmpty() Return whether or not the card stack is empty.
boolean	playTo(Card card) Given a card to be played to the top of this card stack, either make the legal play and return true, or ignore the illegal play and return false.
boolean	playTo(CardStack otherStack) Given a stack from which the top card is to be played to the top of this card stack, either make the legal play and return true, or ignore the illegal play and return false.
Card	removeTopCard() Remove the top card and return it (or null if empty).
int	size() Return the size of the card stack.
Card[]	toArray() Return an array of Card objects in this stack, ordered bottom to top.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

stack

protected java.util.Stack<Card> stack

Constructor Detail

CardStack

public CardStack()

Method Detail

addCard

public void addCard(Card card)

Add the given card to the top of the stack.

Parameters:

card - card to add

canPlayFrom

public boolean canPlayFrom()

Return whether or not a card may be removed from this stack.

Returns:

whether or not a card may be removed from this stack

getTopCard

public Card getTopCard()

Return the top card (or null if empty).

Returns:

the top card (or null if empty)

isEmpty

public boolean isEmpty()

Return whether or not the card stack is empty.

Returns:

whether or not the card stack is empty

playTo

public boolean playTo(Card card)

Given a card to be played to the top of this card stack, either make the legal play and return true, or ignore the illegal play and return false.

Parameters:

card - card to be played onto this card stack

Returns:

whether or not the card was played onto this card stack

playTo

public boolean playTo(CardStack otherStack)

Given a stack from which the top card is to be played to the top of this card stack, either make the legal play and return true, or ignore the illegal play and return false.

Parameters:

otherStack - the other stack from which the top card is to be played

Returns:

whether or not the card was played onto this card stack

removeTopCard

public Card removeTopCard()

Remove the top card and return it (or null if empty).

Returns:

the top card (or null if empty)

size

public int size()

Return the size of the card stack.

Returns:

the size of the card stack

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toArray

public Card[] toArray()

Return an array of Card objects in this stack, ordered bottom to top.

Returns:

an array of Card objects in this stack, ordered bottom to top