|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.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 |
---|
NumberFormat.Field |
Field Summary |
---|
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(NumberFormat format)
Create an improper formatting instance with a custom number format for both the numerator and denominator. |
|
FractionFormat(NumberFormat numeratorFormat,
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 | |
---|---|
StringBuffer |
format(Fraction fraction,
StringBuffer toAppendTo,
FieldPosition pos)
Formats a Fraction object to produce a string. |
StringBuffer |
format(Object obj,
StringBuffer toAppendTo,
FieldPosition pos)
Formats an object and appends the result to a StringBuffer. |
static String |
formatFraction(Fraction f)
This static method calls formatFraction() on a default instance of FractionFormat. |
static Locale[] |
getAvailableLocales()
Get the set of locales for which complex formats are available. |
protected static NumberFormat |
getDefaultNumberFormat()
Create a default number format. |
static FractionFormat |
getImproperInstance()
Returns the default complex format for the current locale. |
static FractionFormat |
getImproperInstance(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(Locale locale)
Returns the default complex format for the given locale. |
Fraction |
parse(String source)
Parses a string to produce a Fraction object. |
Fraction |
parse(String source,
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.Format |
---|
format, formatToCharacterIterator, parseObject |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public FractionFormat()
public FractionFormat(NumberFormat format)
format
- the custom format for both the numerator and denominator.public FractionFormat(NumberFormat numeratorFormat, NumberFormat denominatorFormat)
numeratorFormat
- the custom format for the numerator.denominatorFormat
- the custom format for the denominator.Method Detail |
---|
public static Locale[] getAvailableLocales()
NumberFormat
set.
public static String formatFraction(Fraction f)
f
- Fraction object to format
public static FractionFormat getImproperInstance()
public static FractionFormat getImproperInstance(Locale locale)
locale
- the specific locale used by the format.
public static FractionFormat getProperInstance()
public static FractionFormat getProperInstance(Locale locale)
locale
- the specific locale used by the format.
protected static NumberFormat getDefaultNumberFormat()
NumberFormat.getNumberInstance(java.util.Locale)
with the only
customizing is the maximum number of fraction digits, which is set to 0.
public StringBuffer format(Fraction fraction, StringBuffer toAppendTo, 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 StringBuffer format(Object obj, StringBuffer toAppendTo, 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 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(String source) throws MathParseException
Fraction
object.
parse
in class NumberFormat
source
- the string to parse
Fraction
object.
MathParseException
- if the beginning of the specified string
cannot be parsed.public Fraction parse(String source, ParsePosition pos)
Fraction
object. This method
expects the string to be formatted as an improper fraction.
parse
in class 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 |