eecs2030.test1

Class Temperature

java.lang.Object

eecs2030.test1.Temperature

public class Temperature
extends Object

A class that represents temperatures in degrees Celcius or degrees Fahrenheit.

Field Summary

Fields

Modifier and Type	Field and Description
static String	CELCIUS The abbreviation of Celcius.
static String	FAHRENHEIT The abbreviation of Fahrenheit

Constructor Summary

Constructors

Constructor and Description
Temperature() Initializes the temperature to 0 degrees Celcius.
Temperature(double temp, String units) Initializes the temperature to the given numeric value having the given units.
Temperature(Temperature other) Initializes the temperature by copying the numeric value and units of another temperature.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj) Compares two temperatures for equality.
double	getTemperature() Gets the numeric value of the temperature using the current units.
String	getUnits() Gets the units of the temperature.
void	setTemperature(double temp) Sets the numeric value of the temperature using the current units.
void	setUnits(String units) Set the units of the temperature.
static double	toCelcius(double degF) Converts a value of degrees Fahrenheit to the equivalent value of degrees Celcius.
static double	toFahrenheit(double degC) Converts a value of degrees Celcius to the equivalent value of degrees Fahrenheit.
String	toString() Returns a string made up of the numeric value of the temperature followed by its units.

Methods inherited from class java.lang.Object

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

Field Detail

CELCIUS

public static final String CELCIUS

The abbreviation of Celcius.

See Also:

Constant Field Values

FAHRENHEIT

public static final String FAHRENHEIT

The abbreviation of Fahrenheit

See Also:

Constant Field Values

Constructor Detail

Temperature

public Temperature()

Initializes the temperature to 0 degrees Celcius.

Temperature

public Temperature(Temperature other)

Initializes the temperature by copying the numeric value and units of another temperature.

Parameters:

other - the temperature to copy

Temperature

public Temperature(double temp,
                   String units)

Initializes the temperature to the given numeric value having the given units.

Parameters:

temp - the temperature

units - the units (Temperature.CELCIUS or Temperature.FAHRENHEIT)

Throws:

IllegalArgumentException - if units is not one of Temperature.CELCIUS or Temperature.FAHRENHEIT

Precondition:

units equal to Temperature.CELCIUS or Temperature.FAHRENHEIT

Method Detail

getTemperature

public double getTemperature()

Gets the numeric value of the temperature using the current units. For instance, the value of degC is 0.0 and the value of degF is 32.0 in the following example:

 Temperature t = new Temperature(0.0, Temperature.CELCIUS);
 double degC = t.getTemperature();
 
 Temperature u = new Temperature(32.0, Temperature.FAHRENHEIT);
 double degF = u.getTemperature();
 

Returns:

the numeric value of the temperature using the current units

setTemperature

public final void setTemperature(double temp)

Sets the numeric value of the temperature using the current units. For instance, the final numeric value of t is 15.0 degrees Celcius in the example below:

 Temperature t = new Temperature(0.0, Temperature.CELCIUS);
 t.setTemperature(15.0);
 

Parameters:

temp - the numeric value of the temperature

getUnits

public String getUnits()

Gets the units of the temperature.

Returns:

Temperature.CELCIUS if the temperature is in Celcius, or Temperature.FAHRENHEIT if the temperature is in Fahrenheit.

setUnits

public final void setUnits(String units)

Set the units of the temperature. This method has the side effect that the numeric value of the temperature changes to reflect the change in units. For instance, changing the units of 0 degrees Celcius to Fahrenheit causes the value of degF to be 32.0 (because 0C is equal to 32F):

 Temperature t = new Temperature(0, Temperature.CELCIUS);
 t.setUnits(Temperature.FAHRENHEIT);
 double degF = t.getTemperature();    // degF is equal to 32.0
 String units = t.getUnits();         // units is equal to Temperature.FAHRENHEIT 
 

Parameters:

units - the units of the temperature (Temperature.CELCIUS or Temperature.FAHRENHEIT)

Throws:

IllegalArgumentException - if units is not one of Temperature.CELCIUS or Temperature.FAHRENHEIT

Precondition:

units equal to Temperature.CELCIUS or Temperature.FAHRENHEIT

toCelcius

public static double toCelcius(double degF)

Converts a value of degrees Fahrenheit to the equivalent value of degrees Celcius. The formula to convert degrees Fahrenheit to degrees Celcius is:

C = (F - 32) × (5 / 9)

where F is degrees Fahrenheit and C is degrees Celcius.

Parameters:

degF - a value of degrees Fahrenheit

Returns:

the equivalent value in degrees Celcius

toFahrenheit

public static double toFahrenheit(double degC)

Converts a value of degrees Celcius to the equivalent value of degrees Fahrenheit. The formula to convert degrees Celcius to degrees Fahrenheit is:

F = C × (9 / 5) + 32

where C is degrees Celcius and F is degrees Fahrenheit.

Parameters:

degC - a value of degrees Celcius

Returns:

the equivalent value in degrees Fahrenheit

toString

public String toString()

Returns a string made up of the numeric value of the temperature followed by its units. For example, the Strings

 -12.5C
 73.01234F
 

are returned for temperatures of -12.5 degrees Celcius and 73.01234 degrees Fahrenheit, respectively.

Overrides:

toString in class Object

Returns:

a string representation of the temperature

equals

public boolean equals(Object obj)

Compares two temperatures for equality. Two temperatures are considered equal if they represent the same temperature expressed in degrees Celcius. For instance, the values of eq1 and eq2 are true in the following example:

 Temperature t = new Temperature(0.0, Temperature.CELCIUS);
 Temperature u = new Temperature(32.0, Temperature.FAHRENHEIT);
 boolean eq1 = t.equals(u);
 boolean eq2 = u.equals(t);
 

because 32 degrees Fahrenheit is equivalent to 0 degrees Celcius, and vice versa.

Overrides:

equals in class Object