Enum Class Speed

java.lang.Object

java.lang.Enum<Speed>

org.tquadrat.foundation.value.Speed

All Implemented Interfaces:

Serializable, Comparable<Speed>, Constable, Dimension, DimensionWithLinearConversion

@ClassVersion(sourceVersion="$Id: Speed.java 1195 2026-04-15 21:33:40Z tquadrat $")
@API(status=STABLE,
     since="0.0.4")
public enum Speed
extends Enum<Speed>
implements DimensionWithLinearConversion

The various instances of speed …

Because speed is distance per time, the values for factor() are calculated based on the values from Length.factor() and Time.factor().

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: Speed.java 1195 2026-04-15 21:33:40Z tquadrat $

Since:

0.0.4

UML Diagram

⁠

UML Diagram for "org.tquadrat.foundation.value.Speed"

⁠

Nested Class Summary

Nested classes/interfaces inherited from class Enum

Enum.EnumDesc<E>

Enum Constant Summary

Enum Constants

Enum Constant	Description
ÅNGSTRÖM_PER_WEEK	Ångström per Week.
FEET_PER_SECOND	Feet per second.
KILOMETER_PER_HOUR	Kilometer per hour.
KNOT	Knot (nautical mile per hour).
METER_PER_SECOND	Meter per second.
MILE_PER_HOUR	Mile per hour.

Field Summary

Fields

Modifier and Type	Field	Description
private final BigDecimal	m_Factor	The factor.
private final String	m_UnitSymbol	The unit symbol.

Fields inherited from interface DimensionWithLinearConversion

MSG_UnknownUnit

Constructor Summary

Constructors

Modifier	Constructor	Description
private	Speed(BigDecimal factor, String unitSymbol)	Creates a new Speed instance.

Method Summary

Modifier and Type	Method	Description
final Speed	baseUnit()
final BigDecimal	factor()
static final Speed	forUnit(String unitSymbol)	Returns the Speed instance for the given unit.
final String	unitSymbol()
static Speed	valueOf(String name)	Returns the enum constant of this class with the specified name.
static Speed[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.

Methods inherited from class Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface Dimension

equals, getPrecision, name, toString, unitSymbolForPrinting

Methods inherited from interface DimensionWithLinearConversion

fromBase, toBase

Enum Constant Details

ÅNGSTRÖM_PER_WEEK

public static final Speed ÅNGSTRÖM_PER_WEEK

Ångström per Week. This is by far not a useful unit for speed, but it is the implementation of a famous instance of Murphy's Laws:

"Units are always provided in the most impractical form, e.g. a speed as Ångström per Week."

FEET_PER_SECOND

public static final Speed FEET_PER_SECOND

Feet per second.

KNOT

public static final Speed KNOT

Knot (nautical mile per hour).

KILOMETER_PER_HOUR

public static final Speed KILOMETER_PER_HOUR

Kilometer per hour.

METER_PER_SECOND

public static final Speed METER_PER_SECOND

Meter per second.

MILE_PER_HOUR

public static final Speed MILE_PER_HOUR

Mile per hour.

Field Details

m_Factor

private final BigDecimal m_Factor

The factor.

m_UnitSymbol

private final String m_UnitSymbol

The unit symbol.

Constructor Details

Speed

private Speed(BigDecimal factor,
 String unitSymbol)

Creates a new Speed instance.

Parameters:

factor - The factor.

unitSymbol - The unit symbol.

Method Details

values

public static Speed[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

an array containing the constants of this enum class, in the order they are declared

valueOf

public static Speed valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum class has no constant with the specified name

NullPointerException - if the argument is null

baseUnit

public final Speed baseUnit()

Specified by:

baseUnit in interface Dimension

factor

public final BigDecimal factor()

Specified by:

factor in interface DimensionWithLinearConversion

forUnit

public static final Speed forUnit(String unitSymbol)
                           throws IllegalArgumentException

Returns the Speed instance for the given unit.

Parameters:

unitSymbol - The unit symbol.

Returns:

The respective instance.

Throws:

IllegalArgumentException - The given unit is unknown.

unitSymbol

public final String unitSymbol()

Specified by:

unitSymbol in interface Dimension