public final class MultiplyConverter extends UnitConverter
This class represents a converter multiplying numeric values by a
constant scaling factor (approximated as a double).
For exact scaling conversions RationalConverter is preferred.
Instances of this class are immutable.
IDENTITY| Constructor and Description |
|---|
MultiplyConverter(double factor)
Creates a multiply converter with the specified scale factor.
|
| Modifier and Type | Method and Description |
|---|---|
UnitConverter |
concatenate(UnitConverter converter)
Concatenates this converter with another converter.
|
double |
convert(double amount)
Converts a double value.
|
double |
getFactor()
Returns the scale factor.
|
UnitConverter |
inverse()
Returns the inverse of this converter.
|
boolean |
isLinear()
Indicates if this converter is linear.
|
equals, hashCodepublic MultiplyConverter(double factor)
factor - the scale factor.java.lang.IllegalArgumentException - if offset is one (or close to one).public double getFactor()
public UnitConverter inverse()
UnitConverterx is a valid
value, then x == inverse().convert(convert(x)) to within
the accuracy of computer arithmetic.inverse in class UnitConverterpublic double convert(double amount)
UnitConverterconvert in class UnitConverteramount - the numeric value to convert.public boolean isLinear()
UnitConverterconvert(u + v) == convert(u) + convert(v) and
convert(r * u) == r * convert(u).
For linear converters the following property always hold:[code]
y1 = c1.convert(x1);
y2 = c2.convert(x2);
then y1*y2 = c1.concatenate(c2).convert(x1*x2)[/code]isLinear in class UnitConvertertrue if this converter is linear;
false otherwise.public UnitConverter concatenate(UnitConverter converter)
UnitConverterNote: Implementations must ensure that the UnitConverter.IDENTITY instance
is returned if the resulting converter is an identity
converter.
concatenate in class UnitConverterconverter - the other converter.