org.decimal4j.arithmetic

Class StringConversion

java.lang.Object

org.decimal4j.arithmetic.StringConversion

final class StringConversion
extends Object

Contains methods to convert from and to String.

Field Summary

Fields

Modifier and Type	Field and Description
(package private) static ThreadLocal<StringBuilder>	STRING_BUILDER_THREAD_LOCAL Thread-local used to build Decimal strings.

Method Summary

Methods

Modifier and Type	Method and Description
(package private) static String	longToString(long value) Returns a String object representing the specified long.
(package private) static void	longToString(long value, Appendable appendable) Creates a String object representing the specified long and appends it to the given appendable.
(package private) static long	parseLong(DecimalArithmetic arith, DecimalRounding rounding, CharSequence s, int start, int end) Parses the given string into a long and returns it, rounding extra digits if necessary.
(package private) static long	parseUnscaledDecimal(DecimalArithmetic arith, DecimalRounding rounding, CharSequence s, int start, int end) Parses the given string into an unscaled decimal and returns it, rounding extra digits if necessary.
(package private) static String	unscaledToString(DecimalArithmetic arith, long uDecimal) Returns a String object representing the specified unscaled Decimal value uDecimal.
(package private) static void	unscaledToString(DecimalArithmetic arith, long uDecimal, Appendable appendable) Constructs a String object representing the specified unscaled Decimal value uDecimal and appends the constructed string to the given appendable argument.

Methods inherited from class java.lang.Object

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

Field Detail

STRING_BUILDER_THREAD_LOCAL

static final ThreadLocal<StringBuilder> STRING_BUILDER_THREAD_LOCAL

Thread-local used to build Decimal strings. Allocated big enough to avoid growth.

Method Detail

parseLong

static final long parseLong(DecimalArithmetic arith,
             DecimalRounding rounding,
             CharSequence s,
             int start,
             int end)

Parses the given string into a long and returns it, rounding extra digits if necessary.

Parameters:

arith - the arithmetic of the target value

rounding - the rounding to apply if a fraction is present

s - the string to parse

start - the start index to read characters in s, inclusive

end - the end index where to stop reading in characters in s, exclusive

Returns:

the parsed value

Throws:

IndexOutOfBoundsException - if start < 0 or end > s.length()

NumberFormatException - if value does not represent a valid Decimal or if the value is too large to be represented as a long

parseUnscaledDecimal

static final long parseUnscaledDecimal(DecimalArithmetic arith,
                        DecimalRounding rounding,
                        CharSequence s,
                        int start,
                        int end)

Parses the given string into an unscaled decimal and returns it, rounding extra digits if necessary.

Parameters:

arith - the arithmetic of the target value

rounding - the rounding to apply if extra fraction digits are present

s - the string to parse

start - the start index to read characters in s, inclusive

end - the end index where to stop reading in characters in s, exclusive

Returns:

the parsed value

Throws:

IndexOutOfBoundsException - if start < 0 or end > s.length()

NumberFormatException - if value does not represent a valid Decimal or if the value is too large to be represented as a Decimal with the scale of the given arithmetic

longToString

static final String longToString(long value)

Returns a String object representing the specified long. The argument is converted to signed decimal representation and returned as a string, exactly as if passed to Long.toString(long).

Parameters:

value - a long to be converted.

Returns:

a string representation of the argument in base 10.

longToString

static final void longToString(long value,
                Appendable appendable)
                        throws IOException

Creates a String object representing the specified long and appends it to the given appendable.

Parameters:

value - a long to be converted.

appendable - t the appendable to which the string is to be appended

Throws:

IOException - If an I/O error occurs when appending to appendable

unscaledToString

static final String unscaledToString(DecimalArithmetic arith,
                      long uDecimal)

Returns a String object representing the specified unscaled Decimal value uDecimal. The argument is converted to signed decimal representation and returned as a string with scale decimal places event if trailing fraction digits are zero.

Parameters:

uDecimal - a unscaled Decimal to be converted

arith - the decimal arithmetics providing the scale to apply

Returns:

a string representation of the argument

unscaledToString

static final void unscaledToString(DecimalArithmetic arith,
                    long uDecimal,
                    Appendable appendable)
                            throws IOException

Constructs a String object representing the specified unscaled Decimal value uDecimal and appends the constructed string to the given appendable argument. The value is converted to signed decimal representation and converted to a string with scale decimal places event if trailing fraction digits are zero.

Parameters:

uDecimal - a unscaled Decimal to be converted to a string

arith - the decimal arithmetics providing the scale to apply

appendable - t the appendable to which the string is to be appended

Throws:

IOException - If an I/O error occurs when appending to appendable