net.openhft.chronicle.wire.converter

Class SizeLongConverter

java.lang.Object

net.openhft.chronicle.wire.converter.SizeLongConverter

All Implemented Interfaces:

LongConverter

public class SizeLongConverter
extends Object
implements LongConverter

A converter for long values that translates between numeric values and their string representations with a size suffix (K, M, G, T) to indicate the magnitude (kilo, mega, giga, tera). This class implements the LongConverter interface, providing methods to parse a string with a size suffix back into a long value and to convert a long value into its string representation with the appropriate size suffix.

Field Summary

Fields

Modifier and Type	Field and Description
static SizeLongConverter	INSTANCE The singleton instance of this class.

Constructor Summary

Constructors

Constructor and Description
SizeLongConverter()

Method Summary

Modifier and Type	Method and Description
void	append(StringBuilder text, long value) Converts a long value to its string representation, appending a size suffix (K, M, G, T) if the value is a multiple of 1024 to a power (kilo, mega, giga, tera, respectively).
long	parse(CharSequence text) Parses a string representation of a number with a size suffix (K, M, G, T) and converts it into a long value.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.openhft.chronicle.wire.LongConverter

addEncode, allSafeChars, allSafeChars, append, asString, asText, asText, forSymbols, lengthCheck, lengthCheck, maxParseLength, maxParseLength, parse

Field Detail

INSTANCE

public static final SizeLongConverter INSTANCE

The singleton instance of this class.

Constructor Detail

SizeLongConverter

public SizeLongConverter()

Method Detail

parse

public long parse(CharSequence text)
           throws NumberFormatException

Parses a string representation of a number with a size suffix (K, M, G, T) and converts it into a long value. The suffix indicates the magnitude (kilo for K, mega for M, giga for G, tera for T) of the number, multiplying the parsed number by 1024 to the power corresponding to the suffix.

Specified by:

parse in interface LongConverter

Parameters:

text - The text to parse, containing a numeric value followed by a size suffix (K, M, G, T). Case-insensitive.

Returns:

The parsed long value, adjusted for the size suffix. If no suffix is provided, returns the plain numeric value.

Throws:

NumberFormatException - If the text before the size suffix is not a valid long number or if the text is empty.

append

public void append(StringBuilder text,
                   long value)

Converts a long value to its string representation, appending a size suffix (K, M, G, T) if the value is a multiple of 1024 to a power (kilo, mega, giga, tera, respectively). If the value does not match one of these categories, it is converted to a string without a suffix.

Specified by:

append in interface LongConverter

Parameters:

text - The StringBuilder to which the converted value and suffix are appended.

value - The long value to be converted.