Package org.hipparchus.fraction
Class ProperBigFractionFormat
java.lang.Object
java.text.Format
java.text.NumberFormat
org.hipparchus.fraction.BigFractionFormat
org.hipparchus.fraction.ProperBigFractionFormat
- All Implemented Interfaces:
Serializable
,Cloneable
Formats a BigFraction number in proper format. The number format
for each of the whole number, numerator and, denominator can be configured.
Minus signs are only allowed in the whole number part - i.e.,
"-3 1/2" is legitimate and denotes -7/2, but "-3 -1/2" is invalid and
will result in a ParseException
.
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class java.text.NumberFormat
NumberFormat.Field, NumberFormat.Style
-
Field Summary
Fields inherited from class java.text.NumberFormat
FRACTION_FIELD, INTEGER_FIELD
-
Constructor Summary
ConstructorDescriptionCreate a proper formatting instance with the default number format for the whole, numerator, and denominator.ProperBigFractionFormat
(NumberFormat format) Create a proper formatting instance with a custom number format for the whole, numerator, and denominator.ProperBigFractionFormat
(NumberFormat wholeFormat, NumberFormat numeratorFormat, NumberFormat denominatorFormat) Create a proper formatting instance with a custom number format for each of the whole, numerator, and denominator. -
Method Summary
Modifier and TypeMethodDescriptionformat
(double value, StringBuffer buffer, FieldPosition position) Formats a double value as a fraction and appends the result to a StringBuffer.format
(long value, StringBuffer buffer, FieldPosition position) Formats a long value as a fraction and appends the result to a StringBuffer.format
(BigFraction fraction, StringBuffer toAppendTo, FieldPosition pos) Formats aBigFraction
object to produce a string.protected static NumberFormat
Create a default number format.protected static NumberFormat
getDefaultNumberFormat
(Locale locale) Create a default number format.Access the denominator format.Access the numerator format.Access the whole format.parse
(String source, ParsePosition pos) Parses a string to produce aBigFraction
object.protected static void
parseAndIgnoreWhitespace
(String source, ParsePosition pos) Parsessource
until a non-whitespace character is found.protected static char
parseNextCharacter
(String source, ParsePosition pos) Parsessource
until a non-whitespace character is found.Methods inherited from class org.hipparchus.fraction.BigFractionFormat
format, formatBigFraction, getAvailableLocales, getImproperInstance, getImproperInstance, getProperInstance, getProperInstance, parse, parseNextBigInteger
Methods inherited from class java.text.NumberFormat
clone, equals, format, format, getCompactNumberInstance, getCompactNumberInstance, 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
-
Constructor Details
-
ProperBigFractionFormat
public ProperBigFractionFormat()Create a proper formatting instance with the default number format for the whole, numerator, and denominator. -
ProperBigFractionFormat
Create a proper formatting instance with a custom number format for the whole, numerator, and denominator.- Parameters:
format
- the custom format for the whole, numerator, and denominator.- Throws:
NullArgumentException
- if the provided format is null.
-
ProperBigFractionFormat
public ProperBigFractionFormat(NumberFormat wholeFormat, NumberFormat numeratorFormat, NumberFormat denominatorFormat) Create a proper formatting instance with a custom number format for each of the whole, numerator, and denominator.- Parameters:
wholeFormat
- the custom format for the whole.numeratorFormat
- the custom format for the numerator.denominatorFormat
- the custom format for the denominator.- Throws:
NullArgumentException
- if either provided format is null.
-
-
Method Details
-
format
Formats aBigFraction
object to produce a string. The BigFraction is output in proper format.- Overrides:
format
in classBigFractionFormat
- Parameters:
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- Returns:
- the value passed in as toAppendTo.
-
getWholeFormat
Access the whole format.- Returns:
- the whole format.
-
parse
Parses a string to produce aBigFraction
object. This method expects the string to be formatted as a proper BigFraction.Minus signs are only allowed in the whole number part - i.e., "-3 1/2" is legitimate and denotes -7/2, but "-3 -1/2" is invalid and will result in a
ParseException
.- Overrides:
parse
in classBigFractionFormat
- Parameters:
source
- the string to parsepos
- input/ouput parsing parameter.- Returns:
- the parsed
BigFraction
object.
-
getDefaultNumberFormat
Create a default number format. The default number format is based onNumberFormat.getNumberInstance(java.util.Locale)
. The only customization is the maximum number of BigFraction digits, which is set to 0.- Returns:
- the default number format.
-
getDefaultNumberFormat
Create a default number format. The default number format is based onNumberFormat.getNumberInstance(java.util.Locale)
. The only customization is the maximum number of BigFraction digits, which is set to 0.- Parameters:
locale
- the specific locale used by the format.- Returns:
- the default number format specific to the given locale.
-
getDenominatorFormat
Access the denominator format.- Returns:
- the denominator format.
-
getNumeratorFormat
Access the numerator format.- Returns:
- the numerator format.
-
parseAndIgnoreWhitespace
Parsessource
until a non-whitespace character is found.- Parameters:
source
- the string to parsepos
- input/output parsing parameter. On output,pos
holds the index of the next non-whitespace character.
-
parseNextCharacter
Parsessource
until a non-whitespace character is found.- Parameters:
source
- the string to parsepos
- input/output parsing parameter.- Returns:
- the first non-whitespace character.
-
format
Formats a double value as a fraction and appends the result to a StringBuffer.- Specified by:
format
in classNumberFormat
- Parameters:
value
- the double value to formatbuffer
- StringBuffer to append toposition
- On input: an alignment field, if desired. On output: the offsets of the alignment field- Returns:
- a reference to the appended buffer
- See Also:
-
format
Formats a long value as a fraction and appends the result to a StringBuffer.- Specified by:
format
in classNumberFormat
- Parameters:
value
- the long value to formatbuffer
- StringBuffer to append toposition
- On input: an alignment field, if desired. On output: the offsets of the alignment field- Returns:
- a reference to the appended buffer
- See Also:
-