net.openhft.chronicle.bytes.render

Interface DecimalAppender

All Known Implementing Classes:

AbstractBytes, GuardedNativeBytes, HexDumpBytes, MappedBytes, NativeBytes, OnHeapBytes, SubBytes, UncheckedBytes, UncheckedNativeBytes, VanillaBytes

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface DecimalAppender

This interface represents a handler for decimal numbers, and defines how they should be appended in various forms. Implementations of this interface should provide strategies for handling the individual components of a decimal number, including its sign, mantissa, and exponent.

A decimal number is represented as: decimal = sign * mantissa * 10 ^ (-exponent), where:

• sign is -1 if the number is negative, +1 otherwise.
• mantissa holds the significant digits of the decimal number.
• exponent denotes the power of 10 by which the mantissa is scaled.

Implementations of this interface should provide strategies to handle these individual components.

Method Summary

Modifier and Type	Method and Description
void	append(boolean isNegative, long mantissa, int exponent) Appends a decimal number, represented by its sign, mantissa, and exponent, to a target.

Method Detail

append

void append(boolean isNegative,
            long mantissa,
            int exponent)
     throws net.openhft.chronicle.core.io.ClosedIllegalStateException,
            net.openhft.chronicle.core.io.ThreadingIllegalStateException

Appends a decimal number, represented by its sign, mantissa, and exponent, to a target. The target can be any object that consumes these components, such as a StringBuilder or a file stream.

Parameters:

isNegative - Whether the number is negative. true indicates a negative number, false indicates a positive number.

mantissa - The significant digits of the decimal number, represented as a long integer.

exponent - The power of 10 by which the mantissa is scaled to obtain the actual decimal number.

Throws:

net.openhft.chronicle.core.io.ClosedIllegalStateException - If the resource has been released or closed.

net.openhft.chronicle.core.io.ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way