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

Handler for decimal numbers extracted by a Decimaliser. Implementations must document their threading guarantees. In Chronicle Bytes a typical implementation appends directly to a byte buffer without allocation.

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) Append 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

Append a decimal number, represented by its sign, mantissa and exponent, to a target. The target is often a BytesOut buffer.

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 ten by which the mantissa is scaled, typically in the range 0-18.

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