net.openhft.chronicle.bytes.render

Class SimpleDecimaliser

java.lang.Object

net.openhft.chronicle.bytes.render.SimpleDecimaliser

All Implemented Interfaces:

Decimaliser

public class SimpleDecimaliser
extends Object
implements Decimaliser

A lightweight Decimaliser using simple rounding. It attempts to represent numbers with up to LARGEST_EXPONENT_IN_LONG decimal places. If the scaled mantissa exceeds MANTISSA_LIMIT the method gives up and returns false.

This approach is optimised for speed and is thread-safe. See MaximumPrecision for a more accurate alternative.

Field Summary

Fields

Modifier and Type	Field and Description
static int	LARGEST_EXPONENT_IN_LONG The largest exponent that can be represented using a long integer.
static Decimaliser	SIMPLE A singleton instance of SimpleDecimaliser for convenient reuse.

Constructor Summary

Constructors

Constructor and Description
SimpleDecimaliser()

Method Summary

Modifier and Type	Method and Description
boolean	toDecimal(double value, DecimalAppender decimalAppender) Convert value using a simple rounding approach and append the result.
boolean	toDecimal(float value, DecimalAppender decimalAppender) Convert value using a simple rounding approach and append the result.

Methods inherited from class java.lang.Object

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

Field Detail

LARGEST_EXPONENT_IN_LONG

public static final int LARGEST_EXPONENT_IN_LONG

The largest exponent that can be represented using a long integer. Beyond this value, the Decimaliser gives up.

See Also:

Constant Field Values

SIMPLE

public static final Decimaliser SIMPLE

A singleton instance of SimpleDecimaliser for convenient reuse. This instance is thread-safe and can be used across multiple threads without synchronization.

Constructor Detail

SimpleDecimaliser

public SimpleDecimaliser()

Method Detail

toDecimal

public boolean toDecimal(double value,
                         DecimalAppender decimalAppender)

Convert value using a simple rounding approach and append the result.

This method iteratively scales the input value by powers of 10, and performs rounding to attempt finding a precise representation. If such representation is found, it is appended using the provided DecimalAppender.

Specified by:

toDecimal in interface Decimaliser

Parameters:

value - the double value to convert; must be finite

decimalAppender - the appender that receives sign, mantissa and exponent

Returns:

true if the value was represented within MANTISSA_LIMIT and LARGEST_EXPONENT_IN_LONG

toDecimal

public boolean toDecimal(float value,
                         DecimalAppender decimalAppender)

Convert value using a simple rounding approach and append the result.

Specified by:

toDecimal in interface Decimaliser

Parameters:

value - the float value to convert; must be finite

decimalAppender - the appender that receives sign, mantissa and exponent

Returns:

true if the value was represented within LARGEST_EXPONENT_IN_LONG