|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.text.Format
java.text.NumberFormat
org.apache.commons.math3.fraction.AbstractFormat
org.apache.commons.math3.fraction.FractionFormat
public class FractionFormat
Formats a Fraction number in proper format or improper format. The number format for each of the whole number, numerator and, denominator can be configured.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class java.text.NumberFormat |
---|
java.text.NumberFormat.Field |
Field Summary | |
---|---|
private static long |
serialVersionUID
Serializable version identifier |
Fields inherited from class java.text.NumberFormat |
---|
FRACTION_FIELD, INTEGER_FIELD |
Constructor Summary | |
---|---|
FractionFormat()
Create an improper formatting instance with the default number format for the numerator and denominator. |
|
FractionFormat(java.text.NumberFormat format)
Create an improper formatting instance with a custom number format for both the numerator and denominator. |
|
FractionFormat(java.text.NumberFormat numeratorFormat,
java.text.NumberFormat denominatorFormat)
Create an improper formatting instance with a custom number format for the numerator and a custom number format for the denominator. |
Method Summary | |
---|---|
java.lang.StringBuffer |
format(Fraction fraction,
java.lang.StringBuffer toAppendTo,
java.text.FieldPosition pos)
Formats a Fraction object to produce a string. |
java.lang.StringBuffer |
format(java.lang.Object obj,
java.lang.StringBuffer toAppendTo,
java.text.FieldPosition pos)
Formats an object and appends the result to a StringBuffer. |
static java.lang.String |
formatFraction(Fraction f)
This static method calls formatFraction() on a default instance of FractionFormat. |
static java.util.Locale[] |
getAvailableLocales()
Get the set of locales for which complex formats are available. |
protected static java.text.NumberFormat |
getDefaultNumberFormat()
Create a default number format. |
static FractionFormat |
getImproperInstance()
Returns the default complex format for the current locale. |
static FractionFormat |
getImproperInstance(java.util.Locale locale)
Returns the default complex format for the given locale. |
static FractionFormat |
getProperInstance()
Returns the default complex format for the current locale. |
static FractionFormat |
getProperInstance(java.util.Locale locale)
Returns the default complex format for the given locale. |
Fraction |
parse(java.lang.String source)
Parses a string to produce a Fraction object. |
Fraction |
parse(java.lang.String source,
java.text.ParsePosition pos)
Parses a string to produce a Fraction object. |
Methods inherited from class org.apache.commons.math3.fraction.AbstractFormat |
---|
format, format, getDefaultNumberFormat, getDenominatorFormat, getNumeratorFormat, parseAndIgnoreWhitespace, parseNextCharacter, setDenominatorFormat, setNumeratorFormat |
Methods inherited from class java.text.NumberFormat |
---|
clone, equals, format, format, getCurrency, getCurrencyInstance, getCurrencyInstance, getInstance, getInstance, getIntegerInstance, getIntegerInstance, getMaximumFractionDigits, getMaximumIntegerDigits, getMinimumFractionDigits, getMinimumIntegerDigits, getNumberInstance, getNumberInstance, getPercentInstance, getPercentInstance, getRoundingMode, hashCode, isGroupingUsed, isParseIntegerOnly, parseObject, setCurrency, setGroupingUsed, setMaximumFractionDigits, setMaximumIntegerDigits, setMinimumFractionDigits, setMinimumIntegerDigits, setParseIntegerOnly, setRoundingMode |
Methods inherited from class java.text.Format |
---|
format, formatToCharacterIterator, parseObject |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
private static final long serialVersionUID
Constructor Detail |
---|
public FractionFormat()
public FractionFormat(java.text.NumberFormat format)
format
- the custom format for both the numerator and denominator.public FractionFormat(java.text.NumberFormat numeratorFormat, java.text.NumberFormat denominatorFormat)
numeratorFormat
- the custom format for the numerator.denominatorFormat
- the custom format for the denominator.Method Detail |
---|
public static java.util.Locale[] getAvailableLocales()
NumberFormat
set.
public static java.lang.String formatFraction(Fraction f)
f
- Fraction object to format
public static FractionFormat getImproperInstance()
public static FractionFormat getImproperInstance(java.util.Locale locale)
locale
- the specific locale used by the format.
public static FractionFormat getProperInstance()
public static FractionFormat getProperInstance(java.util.Locale locale)
locale
- the specific locale used by the format.
protected static java.text.NumberFormat getDefaultNumberFormat()
NumberFormat.getNumberInstance(java.util.Locale)
with the only
customizing is the maximum number of fraction digits, which is set to 0.
public java.lang.StringBuffer format(Fraction fraction, java.lang.StringBuffer toAppendTo, java.text.FieldPosition pos)
Fraction
object to produce a string. The fraction is
output in improper format.
fraction
- the object to format.toAppendTo
- where the text is to be appendedpos
- On input: an alignment field, if desired. On output: the
offsets of the alignment field
public java.lang.StringBuffer format(java.lang.Object obj, java.lang.StringBuffer toAppendTo, java.text.FieldPosition pos) throws FractionConversionException, MathIllegalArgumentException
obj
must be either a
Fraction
object or a Number
object. Any other type of
object will result in an IllegalArgumentException
being thrown.
format
in class java.text.NumberFormat
obj
- the object to format.toAppendTo
- where the text is to be appendedpos
- On input: an alignment field, if desired. On output: the
offsets of the alignment field
FractionConversionException
- if the number cannot be converted to a fraction
MathIllegalArgumentException
- if obj
is not a valid type.Format.format(java.lang.Object, java.lang.StringBuffer, java.text.FieldPosition)
public Fraction parse(java.lang.String source) throws MathParseException
Fraction
object.
parse
in class java.text.NumberFormat
source
- the string to parse
Fraction
object.
MathParseException
- if the beginning of the specified string
cannot be parsed.public Fraction parse(java.lang.String source, java.text.ParsePosition pos)
Fraction
object. This method
expects the string to be formatted as an improper fraction.
parse
in class java.text.NumberFormat
source
- the string to parsepos
- input/output parsing parameter.
Fraction
object.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |