net.openhft.chronicle.bytes.render

Class UsesBigDecimal

java.lang.Object

net.openhft.chronicle.bytes.render.UsesBigDecimal

All Implemented Interfaces:

Decimaliser

public class UsesBigDecimal
extends Object
implements Decimaliser

An implementation of Decimaliser that uses BigDecimal for higher-precision conversions of floating-point numbers to decimal representation.

This implementation is designed for scenarios where precision is of utmost importance, and is suitable for handling very large numbers or numbers with a large number of decimal places.

Note: Using BigDecimal might incur a performance overhead compared to more lightweight approaches.

Field Summary

Fields

Modifier and Type	Field and Description
static Decimaliser	USES_BIG_DECIMAL A singleton instance of UsesBigDecimal for convenient reuse.

Constructor Summary

Constructors

Constructor and Description
UsesBigDecimal()

Method Summary

Modifier and Type	Method and Description
boolean	toDecimal(double value, DecimalAppender decimalAppender) Converts a double value to its decimal representation using BigDecimal and appends it to the provided DecimalAppender.
boolean	toDecimal(float value, DecimalAppender decimalAppender) Converts a float value to its decimal representation using BigDecimal and appends it to the provided DecimalAppender.

Methods inherited from class java.lang.Object

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

Field Detail

USES_BIG_DECIMAL

public static final Decimaliser USES_BIG_DECIMAL

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

Constructor Detail

UsesBigDecimal

public UsesBigDecimal()

Method Detail

toDecimal

public boolean toDecimal(double value,
                         DecimalAppender decimalAppender)

Converts a double value to its decimal representation using BigDecimal and appends it to the provided DecimalAppender.

If the input is not a finite number or is a negative zero, the conversion will not be performed.

Specified by:

toDecimal in interface Decimaliser

Parameters:

value - The double value to be converted.

decimalAppender - The DecimalAppender used to store and append the converted decimal value.

Returns:

true if the conversion and appending were successful, false otherwise.

toDecimal

public boolean toDecimal(float value,
                         DecimalAppender decimalAppender)

Converts a float value to its decimal representation using BigDecimal and appends it to the provided DecimalAppender.

If the input is not a finite number, the conversion will not be performed.

Specified by:

toDecimal in interface Decimaliser

Parameters:

value - The float value to be converted.

decimalAppender - The DecimalAppender used to store and append the converted decimal value.

Returns:

true if the conversion and appending were successful, false otherwise.