Class ChompGame

java.lang.Object

ChompGame

public class ChompGame
extends java.lang.Object

ChompGame - A class for modeling the game of Chomp. Use Chomp for a text-based interface to this class. Note: While the toString() method builds a String, there should be no printing and no input/output in general in this implementation.

Constructor Summary

Constructors

Constructor and Description
ChompGame(int rows, int cols) Create an initial board with the given number of rows and columns with all positions unchomped.

Method Summary

Modifier and Type	Method and Description
boolean	checkIfChomped(int row, int col) Return whether or not the board has been chomped at 0-based index position [row][col].
boolean	chompAt(int row, int col) If a chomp at [row][col] is legal, then (1) chomp all positions in the rectangle of positions with [row][col] being the upper-left-most and [rows-1][cols-1] being the lower-right-most, (2) change the current player from 1 to 2 or vice versa, and (3) return true.
int	getCols() Get the number of columns in the board.
int	getCurrentPlayer() Return the current player number, initially 1 and alternating between 1 and 2 with each successive legal play.
int	getRows() Get the number of rows in the board.
boolean	isGameOver() Return whether or not the game is over, that is, whether or not position [0][0] has been chomped.
boolean	isLegalChomp(int row, int col) Return whether or not a chomp at [row][col] would be a legal chomp, that is, would be both in bounds and not previously chomped.
java.lang.String	toString() Return the String representation of the board, such that each line is terminated with a newline, the first line consists of a space and the digits 0 through (cols-1) and following lines consist of the row index digit followed by asterisks/spaces representing unchomped/chomped positions, respectively.

Methods inherited from class java.lang.Object

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

Constructor Detail

ChompGame

public ChompGame(int rows,
                 int cols)

Create an initial board with the given number of rows and columns with all positions unchomped.

Parameters:

rows - the number of rows in the board

cols - the number of columns in the board

Method Detail

checkIfChomped

public boolean checkIfChomped(int row,
                              int col)

Return whether or not the board has been chomped at 0-based index position [row][col].

Parameters:

row - 0-based row index

col - 0-based column index

Returns:

whether or not the board has been chomped at 0-based index position [row][col]

isLegalChomp

public boolean isLegalChomp(int row,
                            int col)

Return whether or not a chomp at [row][col] would be a legal chomp, that is, would be both in bounds and not previously chomped.

Parameters:

row - hypothetical chomp row

col - hypothetical chomp column

Returns:

whether or not a chomp at [row][col] would be a legal chomp, that is, would be both in bounds and not previously chomped

chompAt

public boolean chompAt(int row,
                       int col)

If a chomp at [row][col] is legal, then (1) chomp all positions in the rectangle of positions with [row][col] being the upper-left-most and [rows-1][cols-1] being the lower-right-most, (2) change the current player from 1 to 2 or vice versa, and (3) return true. If a chomp at [row][col] is not legal, then make no change and return false.

Parameters:

row - row of attempted chomp

col - column of attempted chomp

Returns:

whether or not the chomp move was legal

isGameOver

public boolean isGameOver()

Return whether or not the game is over, that is, whether or not position [0][0] has been chomped.

Returns:

whether or not the game is over, that is, whether or not position [0][0] has been chomped

getRows

public int getRows()

Get the number of rows in the board.

Returns:

the number of rows in the board

getCols

public int getCols()

Get the number of columns in the board.

Returns:

the number of columns in the board

getCurrentPlayer

public int getCurrentPlayer()

Return the current player number, initially 1 and alternating between 1 and 2 with each successive legal play. This alternation takes place only in the chompAt(int row, int col) method when a legal chomp move is made.

Returns:

the current player number

toString

public java.lang.String toString()

Return the String representation of the board, such that each line is terminated with a newline, the first line consists of a space and the digits 0 through (cols-1) and following lines consist of the row index digit followed by asterisks/spaces representing unchomped/chomped positions, respectively.

Overrides:

toString in class java.lang.Object

Returns:

the String representation of the board