test3

Class CellNumber

java.lang.Object

test3.CellNumber

All Implemented Interfaces:

Comparable<CellNumber>

public final class CellNumber
extends Object
implements Comparable<CellNumber>

A class that represents North American cell phone numbers. Every cell number has 10 digits where the first 3 digits are the area code, the next three digits are the exchange code, and the last four digits are the station code.

Constructor Summary

Constructors

Constructor and Description
CellNumber(CellNumber other) Initialize this cell number by copying the area, exchange, and station codes of another cell number.
CellNumber(int areaCode, int exchangeCode, int stationCode) Initialize this cell number given its area code, its exchange code, and its station code.

Method Summary

Modifier and Type	Method and Description
int	compareTo(CellNumber other) Compares two cell numbers for order.
boolean	equals(Object obj) Compares two cell numbers for equality.
int	getAreaCode() Returns the area code.
int	getExchangeCode() Returns the exchange code.
int	getStationCode() Returns the station code.
int	hashCode() Returns a hash code for this cell number.
String	toString() Returns a string representation of this cell number.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CellNumber

public CellNumber(int areaCode,
                  int exchangeCode,
                  int stationCode)

Initialize this cell number given its area code, its exchange code, and its station code.

Parameters:

areaCode - the area code; must be in the range 0-999

exchangeCode - the exchange code; must be in the range 0-999

stationCode - the station code; must be in the range 0-9999

Throws:

IllegalArgumentException - if any of the area code, exchange code or station code are out of range

CellNumber

public CellNumber(CellNumber other)

Initialize this cell number by copying the area, exchange, and station codes of another cell number.

Parameters:

other - the cell number to copy

Method Detail

getAreaCode

public int getAreaCode()

Returns the area code.

Returns:

the area code

getExchangeCode

public int getExchangeCode()

Returns the exchange code.

Returns:

the exchange code

getStationCode

public int getStationCode()

Returns the station code.

Returns:

the station code

toString

public String toString()

Returns a string representation of this cell number. An example of a string representation of a cell number is "(416) 736-2100"

Overrides:

toString in class Object

Returns:

a string representation of this cell number

hashCode

public int hashCode()

Returns a hash code for this cell number.

Overrides:

hashCode in class Object

Returns:

a hash code for this cell number

equals

public boolean equals(Object obj)

Compares two cell numbers for equality. The result is true if and only if the argument is not null and is an CellNumber object that has the same area, exchange, and station code as this cell number.

Overrides:

equals in class Object

Parameters:

obj - the object to compare this cell number against

Returns:

true if the given object represents an CellNumber equivalent to this cell number, false otherwise

compareTo

public int compareTo(CellNumber other)

Compares two cell numbers for order. The cell numbers are compared first by area code, then by exchange code, then by station code.

Specified by:

compareTo in interface Comparable<CellNumber>

Parameters:

other - the cell number to be compared

Returns:

a negative integer if this cell number is less than the other cell number, 0 if this cell number is equal to the other phone number, or a positive integer if this phone number is greater than the other phone number