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<?> destination, long numericValue) Appends a long value to a Bytes object.
void	append(StringBuilder destinationBuilder, long numericValue) Appends a long value to a StringBuilder.
int	maxParseLength() Returns the maximum number of characters that this converter can parse.
long	parse(CharSequence textToParse) Parses a sequence of characters into a long value.
long	parse(CharSequence textToParse, int beginIndex, int endIndex) Parses a part of 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, 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 textToParse)

Parses a sequence of characters into a long value.

Specified by:

parse in interface LongConverter

Parameters:

textToParse - the character sequence to parse

Returns:

the parsed long value.

Throws:

IllegalArgumentException - if the character sequence contains unexpected characters or its length exceeds the maximum allowable length.

parse

public long parse(CharSequence textToParse,
                  int beginIndex,
                  int endIndex)

Parses a part of a sequence of characters into a long value.

Specified by:

parse in interface LongConverter

Parameters:

textToParse - the character sequence to parse

beginIndex - the beginning index, inclusive

endIndex - the ending index, exclusive

Returns:

the parsed long value.

Throws:

IllegalArgumentException - if the character sequence contains unexpected character, or if any of the indices are invalid or the sub-sequence length exceeds the maximum allowable length.

append

public void append(StringBuilder destinationBuilder,
                   long numericValue)

Appends a long value to a StringBuilder.

Specified by:

append in interface LongConverter

Parameters:

destinationBuilder - the StringBuilder to append to

numericValue - the long value to append

append

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

Appends a long value to a Bytes object.

Specified by:

append in interface LongConverter

Parameters:

destination - the Bytes object to append to

numericValue - 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.