Class BreakthroughState

java.lang.Object

BreakthroughState

public class BreakthroughState
extends java.lang.Object

BreakthroughState - a model of a state of the game Breakthrough. See http://en.wikipedia.org/wiki/Breakthrough_(board_game) for details. Following the convention of littlegolem.net, we always have the white player go first. Board row and column numbers are 0-based.

Field Summary

Fields

Modifier and Type	Field and Description
static int	BLACK A constant integer value representing "black piece" (in getPiece(int, int)) and "black player winner" (in getWinner()).
static int	NONE A constant integer value representing "no piece" (in getPiece(int, int)) and "no winner" (in getWinner()).
static int	SIZE The size of the 8-by-8 square grid.
static int	WHITE A constant integer value representing "white piece" (in getPiece(int, int)) and "white player winner" (in getWinner()).

Constructor Summary

Constructors

Constructor and Description
BreakthroughState() Initialize board with WHITE pawns filling rows 0 and 1 and BLACK pawns filling rows 6 and 7.

Method Summary

Methods

Modifier and Type	Method and Description
int	getCurrentPlayer() Return the current player (BLACK/WHITE).
int	getPiece(int row, int col) Return the piece (NONE/BLACK/WHITE) at the given 0-based row and column.
int	getWinner() Return the winner (BLACK/WHITE) of the game or NONE if there is no winner.
boolean	makeMove(int fromRow, int fromCol, int toRow, int toCol) Make a given 0-based move if and only if it is legal and return whether or not the move was legal.

Methods inherited from class java.lang.Object

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

Field Detail

NONE

public static final int NONE

A constant integer value representing "no piece" (in getPiece(int, int)) and "no winner" (in getWinner()).

See Also:

Constant Field Values

BLACK

public static final int BLACK

A constant integer value representing "black piece" (in getPiece(int, int)) and "black player winner" (in getWinner()).

See Also:

Constant Field Values

WHITE

public static final int WHITE

A constant integer value representing "white piece" (in getPiece(int, int)) and "white player winner" (in getWinner()).

See Also:

Constant Field Values

SIZE

public static final int SIZE

The size of the 8-by-8 square grid.

See Also:

Constant Field Values

Constructor Detail

BreakthroughState

public BreakthroughState()

Initialize board with WHITE pawns filling rows 0 and 1 and BLACK pawns filling rows 6 and 7. All other positions have the value NONE. The first player is WHITE by littlegolem.net convention.

Method Detail

getPiece

public int getPiece(int row,
           int col)

Return the piece (NONE/BLACK/WHITE) at the given 0-based row and column.

Parameters:

row - given row

col - given column

Returns:

the piece (NONE/BLACK/WHITE) at the given 0-based row and column

getCurrentPlayer

public int getCurrentPlayer()

Return the current player (BLACK/WHITE).

Returns:

the current player (BLACK/WHITE)

getWinner

public int getWinner()

Return the winner (BLACK/WHITE) of the game or NONE if there is no winner. Because there is no draw in Breakthrough, a return value of NONE implies that the game is not over.

Returns:

the winner (BLACK/WHITE) of the game or NONE if there is no winner

makeMove

public boolean makeMove(int fromRow,
               int fromCol,
               int toRow,
               int toCol)

Make a given 0-based move if and only if it is legal and return whether or not the move was legal.

Parameters:

fromRow - row piece is moved from

fromCol - column piece is moved from

toRow - row piece is moved to

toCol - column piece is moved to

Returns:

whether or not the move was legal (and thus taken)