tec.units.ri.format

Class AbstractUnitFormat

java.lang.Object

tec.units.ri.format.AbstractUnitFormat

All Implemented Interfaces:

javax.measure.format.UnitFormat

Direct Known Subclasses:

SimpleUnitFormat

public abstract class AbstractUnitFormat
extends Object
implements javax.measure.format.UnitFormat

This class provides the interface for formatting and parsing units.

For all metric units, the 20 SI prefixes used to form decimal multiples and sub-multiples of SI units are recognized. For example:
AbstractUnit.parse("m°C").equals(MetricPrefix.MILLI(Units.CELSIUS)) AbstractUnit.parse("kW").equals(MetricPrefix.KILO(Units.WATT))

Version:

1.0, August 9, 2016

Author:

Jean-Marie Dautelle, Werner Keil

Field Summary

Fields

Modifier and Type	Field and Description
protected static Logger	logger serialVersionUID

Constructor Summary

Constructors

Constructor and Description
AbstractUnitFormat()

Method Summary

Methods

Modifier and Type	Method and Description
String	format(javax.measure.Unit<?> unit) Formats an object to produce a string.
abstract Appendable	format(javax.measure.Unit<?> unit, Appendable appendable) Formats the specified unit.
boolean	isLocaleSensitive()
protected abstract javax.measure.Unit<?>	parse(CharSequence csq, int index) Parses a portion of the specified CharSequence from the specified position to produce a unit.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.measure.format.UnitFormat

label, parse

Field Detail

logger

protected static final Logger logger

serialVersionUID

Constructor Detail

AbstractUnitFormat

public AbstractUnitFormat()

Method Detail

format

public final String format(javax.measure.Unit<?> unit)

Formats an object to produce a string. This is equivalent to

format(unit, new StringBuilder()).toString();

Specified by:

format in interface javax.measure.format.UnitFormat

Parameters:

obj - The object to format

Returns:

Formatted string.

Throws:

IllegalArgumentException - if the Format cannot format the given object

format

public abstract Appendable format(javax.measure.Unit<?> unit,
                Appendable appendable)
                           throws IOException

Formats the specified unit.

Specified by:

format in interface javax.measure.format.UnitFormat

Parameters:

unit - the unit to format.

appendable - the appendable destination.

Returns:

The appendable destination passed in as appendable, with formatted text appended.

Throws:

IOException - if an error occurs.

parse

protected abstract javax.measure.Unit<?> parse(CharSequence csq,
                          int index)
                                        throws IllegalArgumentException

Parses a portion of the specified CharSequence from the specified position to produce a unit. If there is no unit to parse AbstractUnit.ONE is returned.

Parameters:

csq - the CharSequence to parse.

index - the current parsing index.

Returns:

the unit parsed from the specified character sub-sequence.

Throws:

IllegalArgumentException - if any problem occurs while parsing the specified character sequence (e.g. illegal syntax).

isLocaleSensitive

public boolean isLocaleSensitive()

Specified by:

isLocaleSensitive in interface javax.measure.format.UnitFormat