Serializable
, Cloneable
ProperFractionFormat
public class FractionFormat extends NumberFormat
The number format for each of the whole number, numerator and, denominator can be configured.
NumberFormat.Field
FRACTION_FIELD, INTEGER_FIELD
Constructor | Description |
---|---|
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.
|
Modifier and Type | Method | Description |
---|---|---|
StringBuffer |
format(double value,
StringBuffer buffer,
FieldPosition position) |
Formats a double value as a fraction and appends the result to a StringBuffer.
|
StringBuffer |
format(long value,
StringBuffer buffer,
FieldPosition position) |
Formats a long value as a fraction and appends the result to a StringBuffer.
|
StringBuffer |
format(Object obj,
StringBuffer toAppendTo,
FieldPosition pos) |
Formats an object and appends the result to a StringBuffer.
|
StringBuffer |
format(Fraction fraction,
StringBuffer toAppendTo,
FieldPosition pos) |
Formats a
Fraction object to produce a string. |
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(Locale locale) |
Create a default number format.
|
protected static NumberFormat |
getDefaultNumberFormat() |
Create a default number format.
|
NumberFormat |
getDenominatorFormat() |
Access the denominator 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.
|
NumberFormat |
getNumeratorFormat() |
Access the numerator format.
|
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. |
protected static void |
parseAndIgnoreWhitespace(String source,
ParsePosition pos) |
Parses
source until a non-whitespace character is found. |
protected static char |
parseNextCharacter(String source,
ParsePosition pos) |
Parses
source until a non-whitespace character is found. |
format, formatToCharacterIterator, parseObject
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
public FractionFormat()
public FractionFormat(NumberFormat format)
format
- the custom format for both the numerator and denominator.NullArgumentException
- if the provided format is null.public FractionFormat(NumberFormat numeratorFormat, NumberFormat denominatorFormat)
numeratorFormat
- the custom format for the numerator.denominatorFormat
- the custom format for the denominator.NullArgumentException
- if either provided format is null.public static Locale[] getAvailableLocales()
NumberFormat
set.public static String formatFraction(Fraction f)
f
- Fraction object to formatpublic 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 fieldpublic StringBuffer format(Object obj, StringBuffer toAppendTo, FieldPosition pos) throws MathIllegalArgumentException, MathIllegalStateException
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 fieldMathIllegalStateException
- if the number cannot be converted to a fractionMathIllegalArgumentException
- if obj
is not a valid type.Format.format(java.lang.Object, java.lang.StringBuffer, java.text.FieldPosition)
public Fraction parse(String source) throws MathIllegalStateException
Fraction
object.parse
in class NumberFormat
source
- the string to parseFraction
object.MathIllegalStateException
- 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.protected static NumberFormat getDefaultNumberFormat(Locale locale)
NumberFormat.getNumberInstance(java.util.Locale)
. The only
customization is the maximum number of BigFraction digits, which is set to 0.locale
- the specific locale used by the format.public NumberFormat getDenominatorFormat()
public NumberFormat getNumeratorFormat()
protected static void parseAndIgnoreWhitespace(String source, ParsePosition pos)
source
until a non-whitespace character is found.source
- the string to parsepos
- input/output parsing parameter. On output, pos
holds the index of the next non-whitespace character.protected static char parseNextCharacter(String source, ParsePosition pos)
source
until a non-whitespace character is found.source
- the string to parsepos
- input/output parsing parameter.public StringBuffer format(double value, StringBuffer buffer, FieldPosition position)
format
in class NumberFormat
value
- the double value to formatbuffer
- StringBuffer to append toposition
- On input: an alignment field, if desired. On output: the
offsets of the alignment fieldNumberFormat.format(Object, StringBuffer, FieldPosition)
public StringBuffer format(long value, StringBuffer buffer, FieldPosition position)
format
in class NumberFormat
value
- the long value to formatbuffer
- StringBuffer to append toposition
- On input: an alignment field, if desired. On output: the
offsets of the alignment fieldNumberFormat.format(Object, StringBuffer, FieldPosition)
Copyright © 2016–2018 Hipparchus.org. All rights reserved.