structure
Class Matrix<ELTTYPE>

java.lang.Object
  structure.Matrix<ELTTYPE>

public class Matrix<ELTTYPE>
extends java.lang.Object

An implementation of rectangular vectors. This implementation of a Matrix is minimal. Few operations are provided, and no support for mathematical operations is considered.

Example Usage:

 public static void main(String[] argv){
        //create an array of arrays to bet copied into the matrix
        int[][] test = new int[][]{new int[]{1,2,3},
                                   new int[]{4,5,6}, 
                                   new int[]{7,8,9}};

        //create the matrix
        Matrix testMatrix = new Matrix(test.length, test[0].length);
        
        //copy the 2-d array into the matrix
        for(int i = 0; i < test.length; i++){
            for(int j = 0; j < test[0].length; j++){
                testMatrix.set(i,j,new Integer(test[i][j]));
            }
        }

        //print out the matrix
        System.out.println(testMatrix);
  }
 

Constructor Summary

Matrix()
Construct an empty matrix.

Matrix(int h, int w)
Constructs a matrix such that all values are null.

Method Summary

void	addCol(int c) Add a new column, whose index will be c.
void	addRow(int r) Add a new row, whose index will be r.
ELTTYPE	get(int row, int col) Fetch an element from the matrix.
int	height() Return the height of the matrix.
Vector<ELTTYPE>	removeCol(int c) Remove a column, whose index is c.
Vector<ELTTYPE>	removeRow(int r) Remove the row whose index is r.
void	set(int row, int col, ELTTYPE value) Change the value at location (row, col)
java.lang.String	toString() Construct a string representation of the matrix.
int	width() Return the width of the matrix.

Methods inherited from class java.lang.Object

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

Constructor Detail

Matrix

public Matrix()

Construct an empty matrix.

Post:

constructs empty matrix

Matrix

public Matrix(int h,
              int w)

Constructs a matrix such that all values are null.

Parameters:

h - Height of the matrix.

w - Width of the matrix.

Pre:

h >= 0, w >= 0;

Post:

constructs an h row by w column matrix

Method Detail

get

public ELTTYPE get(int row,
                   int col)

Fetch an element from the matrix.

Parameters:

row - The row of the element

col - The column of the element

Returns:

Object located at matrix position (row, col)

Pre:

0 <= row < height(), 0 <= col < width()

Post:

returns object at (row, col)

set

public void set(int row,
                int col,
                ELTTYPE value)

Change the value at location (row, col)

Parameters:

value - The new Object reference (possibly null).

row - The row of the value to be changed.

col - The column of the value to be changed.

Pre:

0 <= row < height(), 0 <= col < width()

Post:

changes location (row, col) to value

addRow

public void addRow(int r)

Add a new row, whose index will be r.

Parameters:

r - The index of the newly inserted row.

Pre:

0 <= r < height()

Post:

inserts row of null values to be row r

addCol

public void addCol(int c)

Add a new column, whose index will be c.

Parameters:

c - The index of the newly inserted column.

Pre:

0 <= c < width()

Post:

inserts column of null values to be column c

removeRow

public Vector<ELTTYPE> removeRow(int r)

Remove the row whose index is r. The row is returned as a vector.

Parameters:

r - The index of the to-be-removed row.

Returns:

A vector of values once in the row.

Pre:

0 <= r < height()

Post:

removes row r and returns it as a Vector

removeCol

public Vector<ELTTYPE> removeCol(int c)

Remove a column, whose index is c.

Parameters:

c - The index of the column to be removed.

Returns:

A vector of the values removed.

Pre:

0 <= c < width

Post:

removes column c and returns it as a vector

width

public int width()

Return the width of the matrix.

Returns:

The number of columns in the matrix.

Post:

returns number of columns in matrix

height

public int height()

Return the height of the matrix.

Returns:

The number of rows in the matrix.

Post:

returns number of rows in matrix

toString

public java.lang.String toString()

Construct a string representation of the matrix.

Overrides:

toString in class java.lang.Object

Returns:

A string, representing the matrix.

Post:

returns string description of matrix.