net.openhft.chronicle.wire.converter

Class PowerOfTwoLongConverter

java.lang.Object

net.openhft.chronicle.wire.converter.PowerOfTwoLongConverter

All Implemented Interfaces:

LongConverter

public class PowerOfTwoLongConverter
extends Object
implements LongConverter

A specialized implementation of the LongConverter interface for converting long values to and from strings using power-of-two bases.

This converter leverages certain mathematical properties of power-of-two bases to optimize the conversion process.

Constructor Summary

Constructors

Constructor and Description
PowerOfTwoLongConverter(String symbols) Initializes a new instance with a given set of symbols.

Method Summary

Modifier and Type	Method and Description
void	addEncode(char alias, char as) Adds an alias character for encoding.
void	append(net.openhft.chronicle.bytes.Bytes<?> text, long value) Appends a long value to a Bytes object.
void	append(StringBuilder text, long value) Appends a long value to a StringBuilder.
int	maxParseLength() Returns the maximum number of characters that this converter can parse.
long	parse(CharSequence text) Parses a sequence of characters 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

allSafeChars, asString, asText, asText, forSymbols, lengthCheck, maxParseLength

Constructor Detail

PowerOfTwoLongConverter

public PowerOfTwoLongConverter(String symbols)

Initializes a new instance with a given set of symbols.

Parameters:

symbols - A string containing unique symbols for conversion. The length of this string should be a power of 2.

Method Detail

maxParseLength

public int maxParseLength()

Description copied from interface: LongConverter

Returns the maximum number of characters that this converter can parse.

Specified by:

maxParseLength in interface LongConverter

Returns:

The maximum parse length, or Integer.MAX_VALUE if there's no limit.

parse

public long parse(CharSequence text)

Parses a sequence of characters into a long value.

Specified by:

parse in interface LongConverter

Parameters:

text - the character sequence to parse

Returns:

the parsed long value

Throws:

IllegalArgumentException - if the character sequence contains unexpected characters

append

public void append(StringBuilder text,
                   long value)

Appends a long value to a StringBuilder.

Specified by:

append in interface LongConverter

Parameters:

text - the StringBuilder to append to

value - the long value to append

append

public void append(net.openhft.chronicle.bytes.Bytes<?> text,
                   long value)

Appends a long value to a Bytes object.

Specified by:

append in interface LongConverter

Parameters:

text - the Bytes object to append to

value - the long value to append

addEncode

public void addEncode(char alias,
                      char as)

Adds an alias character for encoding. The alias character will be treated the same as the "as" character in the encoding process.

Specified by:

addEncode in interface LongConverter

Parameters:

alias - The character to treat as an alias.

as - The character that the alias should be treated as.