week2

Class DeckOfCards

java.lang.Object

week2.DeckOfCards

public class DeckOfCards
extends java.lang.Object

This class simulates a deck of playing cards.

February 1999
sort method added April 2002
Modified January 2014

Author:

Craig Miller

Constructor Summary

Constructors

Constructor and Description
DeckOfCards() This creates a deck of 52 cards.

Method Summary

Modifier and Type	Method and Description
void	cut() This method simulates cutting the deck.
Card	draw() This method simulates drawing a card from the top of the deck.
Card	getCard(int index) Reveals value of a card in the deck
boolean	isEmpty() Indicates if the deck is empty.
static void	main(java.lang.String[] args)
void	placeOnBottom(Card c) This method simulates placing a card on the bottom of the deck.
Card	revealTopCard() Reveals the top card of the deck.
void	shuffle() This method simulates shuffling the deck.
int	size() Indicates the number of cards in the deck
void	sort() This method sorts the deck by rank.

Methods inherited from class java.lang.Object

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

Constructor Detail

DeckOfCards

public DeckOfCards()

This creates a deck of 52 cards. These cards are not shuffled.

Method Detail

draw

public Card draw()

This method simulates drawing a card from the top of the deck.

Precondition:

The deck is not empty.

Postcondition:

The top card is removed from the deck.

Returns:

the top card

placeOnBottom

public void placeOnBottom(Card c)

This method simulates placing a card on the bottom of the deck.

Parameters:

c - the card to be placed on the bottom of the deck.

Postcondition:

The deck has the given card on the bottom of the deck.

shuffle

public void shuffle()

This method simulates shuffling the deck.

Postcondition:

The cards are in random order.

cut

public void cut()

This method simulates cutting the deck.

Precondition:

The deck has at least 10 cards.

Postcondition:

A random number of cards a moved from the top of the deck to the bottom of the deck. The random number ranges from 5 to number of cards minus 5. If the deck has less than 10 cards, the deck is not cut.

sort

public void sort()

This method sorts the deck by rank.

Postcondition:

For all cards A and B in the deck, if card A is closer to the top than card B, then the rank of card A is equal to or less than the rank of card B.

isEmpty

public boolean isEmpty()

Indicates if the deck is empty.

Returns:

true if the deck is empty, false otherwise.

size

public int size()

Indicates the number of cards in the deck

Returns:

the number of cards in the deck

revealTopCard

public Card revealTopCard()

Reveals the top card of the deck.

Returns:

the top card in the deck without removing it from the deck

getCard

public Card getCard(int index)

Reveals value of a card in the deck

Parameters:

index - specifies the position of the card where 0 is the bottom card and size() - 1 is the top card

Returns:

the card at the specified position

main

public static void main(java.lang.String[] args)