net.openhft.chronicle.bytes

Class NativeBytes<Underlying>

java.lang.Object

net.openhft.chronicle.core.io.AbstractReferenceCounted

net.openhft.chronicle.bytes.AbstractBytes<Underlying>

net.openhft.chronicle.bytes.VanillaBytes<Underlying>

net.openhft.chronicle.bytes.NativeBytes<Underlying>

All Implemented Interfaces:

Appendable, CharSequence, Comparable<CharSequence>, Byteable<Bytes<Underlying>,Underlying>, Bytes<Underlying>, BytesComment<BytesOut<Underlying>>, BytesIn<Underlying>, BytesOut<Underlying>, BytesPrepender<Bytes<Underlying>>, BytesStore<Bytes<Underlying>,Underlying>, ByteStringAppender<Bytes<Underlying>>, RandomDataInput, RandomDataOutput<Bytes<Underlying>>, StreamingCommon<Bytes<Underlying>>, StreamingDataInput<Bytes<Underlying>>, StreamingDataOutput<Bytes<Underlying>>, net.openhft.chronicle.core.io.ReferenceCounted, net.openhft.chronicle.core.io.ReferenceCountedTracer, net.openhft.chronicle.core.io.ReferenceOwner

Direct Known Subclasses:

GuardedNativeBytes

public class NativeBytes<Underlying>
extends VanillaBytes<Underlying>

Elastic memory accessor which can wrap either a ByteBuffer or malloc'ed memory.

This class can wrap heap ByteBuffers, called NativeBytes for historical reasons.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NativeBytes.NativeSubBytes Deprecated.

Field Summary

Fields inherited from class net.openhft.chronicle.bytes.AbstractBytes

bytesStore, isPresent, readPosition, writeLimit, writePosition

Fields inherited from class net.openhft.chronicle.core.io.AbstractReferenceCounted

referenceCounted, WARN_COUNT, WARN_NS

Fields inherited from interface net.openhft.chronicle.bytes.Bytes

DEFAULT_BYTE_BUFFER_CAPACITY, MAX_BYTE_BUFFER_CAPACITY, MAX_CAPACITY, MAX_HEAP_CAPACITY

Fields inherited from interface net.openhft.chronicle.bytes.RandomDataInput

charToString

Fields inherited from interface net.openhft.chronicle.bytes.StreamingDataOutput

JAVA9_STRING_CODER_LATIN, JAVA9_STRING_CODER_UTF16

Constructor Summary

Constructors

Constructor and Description
NativeBytes(@NotNull BytesStore store)
NativeBytes(@NotNull BytesStore store, long capacity)

Method Summary

Modifier and Type	Method and Description
static boolean	areNewGuarded() For testing
protected void	bytesStore(BytesStore<Bytes<Underlying>,Underlying> bytesStore)
void	bytesStore(@NotNull BytesStore<Bytes<Underlying>,Underlying> byteStore, long offset, long length) This setter for a data type which points to an underlying ByteStore.
long	capacity()
static BytesStore<Bytes<Void>,Void>	copyOf(@NotNull Bytes bytes)
void	ensureCapacity(long desiredCapacity) grow the buffer if the buffer is elastic, if the buffer is not elastic and there is not enough capacity then this method will throws BufferOverflowException
boolean	isElastic() Returns if this Bytes is elastic.
boolean	isEqual(long start, long length, String s)
protected static <T> long	maxCapacityFor(@NotNull BytesStore<?,T> bs)
static @NotNull NativeBytes<Void>	nativeBytes()
static @NotNull NativeBytes<Void>	nativeBytes(long initialCapacity)
default void	parse8bit(Appendable buffer, @NotNull StopCharsTester stopCharsTester) parse text with ISO-8859-1 decoding as character terminated.
default void	parse8bit(Appendable buffer, @NotNull StopCharTester stopCharTester) parse text with ISO-8859-1 decoding as character terminated.
default void	parse8bit(Bytes buffer, @NotNull StopCharsTester stopCharsTester)
default String	parse8bit(@NotNull StopCharTester stopCharTester) parse text with ISO-8859-1 decoding as character terminated.
default void	parse8bit(StringBuilder buffer, @NotNull StopCharsTester stopCharsTester)
default @NotNull BigDecimal	parseBigDecimal()
default @Nullable Boolean	parseBoolean()
default @Nullable Boolean	parseBoolean(@NotNull StopCharTester tester) Return true or false, or null if it could not be detected as true or false.
default double	parseDouble() parse text as a double decimal.
default float	parseFloat() parse text as a float decimal.
default int	parseInt() parse text as an int.
default long	parseLong() parse text as a long integer.
default long	parseLongDecimal() Parse the significant digits of a decimal number.
default void	parseUTF(@NotNull Appendable buffer, @NotNull StopCharsTester stopCharsTester) Deprecated.
default void	parseUTF(@NotNull Appendable buffer, @NotNull StopCharTester stopCharTester) Deprecated.
default @NotNull String	parseUTF(@NotNull StopCharTester stopCharTester) Deprecated.
default void	parseUtf8(@NotNull Appendable buffer, @NotNull StopCharsTester stopCharsTester) parse text with UTF-8 decoding as one or two character terminated.
default void	parseUtf8(@NotNull Appendable buffer, @NotNull StopCharTester stopCharTester) parse text with UTF-8 decoding as character terminated.
default @NotNull String	parseUtf8(@NotNull StopCharTester stopCharTester) parse text with UTF-8 decoding as character terminated.
default @NotNull Reader	reader() Access these bytes as an ISO-8859-1 encoded Reader
long	readRemaining()
static void	resetNewGuarded() For testing
static boolean	setNewGuarded(boolean guarded) turn guarding on/off.
default boolean	skipTo(@NotNull StopCharTester tester) Skip text until a terminating character is reached.
static <T> @NotNull NativeBytes<T>	wrapWithNativeBytes(@NotNull BytesStore<?,T> bs, long capacity)
@NotNull Bytes<Underlying>	writeByte(byte i8)
protected void	writeCheckOffset(long offset, long adding)
@NotNull Bytes<Underlying>	writeLong(long i64) Write a long
protected long	writeOffsetPositionMoved(long adding, long advance)
@NotNull NativeBytes	writeSome(@NotNull Bytes bytes)

Methods inherited from class net.openhft.chronicle.bytes.VanillaBytes

append, append8bit, append8bit, append8bit, append8bit0, appendUtf8, appendUtf8, byteCheckSum, bytesForRead, compareTo, copy, equalBytes, isEqual, maxSize, offset, optimisedWrite, read, read8Bit, readVolatileLong, realCapacity, toString, toString0, toTemporaryDirectByteBuffer, vanillaBytes, write, write, write

Methods inherited from class net.openhft.chronicle.bytes.AbstractBytes

addressForRead, addressForWrite, addressForWritePosition, append, byteCheckSum, byteCheckSum, bytesStore, canReadDirect, canWriteDirect, clear, clearAndPad, compact, compareAndSwapInt, compareAndSwapLong, equals, hashCode, isDirectMemory, lastDecimalPlaces, lastDecimalPlaces, lenient, lenient, move, nativeRead, nativeWrite, peekUnsignedByte, peekUnsignedByte, performRelease, prewrite, prewrite, prewriteByte, prewriteInt, prewriteLong, prewriteOffsetPositionMoved, prewriteShort, readByte, readByte, readDouble, readDouble, readFloat, readFloat, readInt, readInt, readLimit, readLimit, readLong, readLong, readOffsetPositionMoved, readPosition, readPosition, readShort, readShort, readSkip, readUnsignedByte, readUnsignedByte, readVolatileByte, readVolatileInt, readVolatileInt, readVolatileLong, readVolatileShort, realWriteRemaining, safeCopySize, start, testAndSetInt, uncheckedReadSkipBackOne, uncheckedReadSkipOne, uncheckedReadUnsignedByte, uncheckedWritePosition, underlyingObject, write, write, write, write, write, write8bit, write8bit, write8bit, write8bit, writeByte, writeDouble, writeDouble, writeDoubleAndInt, writeFloat, writeFloat, writeInt, writeInt, writeIntAdv, writeLimit, writeLimit, writeLong, writeLongAdv, writeOffsetPositionMoved, writeOrderedInt, writeOrderedInt, writeOrderedLong, writeOrderedLong, writePosition, writePosition, writeShort, writeShort, writeSkip, writeSome, writeVolatileByte, writeVolatileInt, writeVolatileLong, writeVolatileShort

Methods inherited from class net.openhft.chronicle.core.io.AbstractReferenceCounted

assertReferencesReleased, createdHere, disableReferenceTracing, enableReferenceTracing, performReleaseInBackground, refCount, referenceId, release, releaseLast, reserve, reservedBy, reserveTransfer, threadSafetyCheck, throwExceptionIfNotReleased, throwExceptionIfReleased, tryReserve, unmonitor, warnAndReleaseIfNotReleased

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.openhft.chronicle.bytes.Byteable

bytesStore

Methods inherited from interface net.openhft.chronicle.bytes.Bytes

allocateDirect, allocateDirect, allocateElasticDirect, allocateElasticDirect, allocateElasticOnHeap, allocateElasticOnHeap, copyTo, copyTo, directFrom, elasticByteBuffer, elasticByteBuffer, elasticByteBuffer, elasticHeapByteBuffer, elasticHeapByteBuffer, forFieldGroup, from, from, fromDirect, fromHexString, fromString, indexOf, indexOf, indexOf, indexOf, isClear, readBigDecimal, readBigInteger, readMarshallableLength16, readWithLength, readWrite, safeLimit, sharedMemory, toHexString, toHexString, toHexString, toString, toString, toString, unchecked, unchecked, unwrite, valueOf, wrapForRead, wrapForRead, wrapForWrite, wrapForWrite, write, writeMarshallableLength16

Methods inherited from interface net.openhft.chronicle.bytes.BytesStore

addAndGetDoubleNotAtomic, addAndGetFloatNotAtomic, addAndGetIntNotAtomic, addAndGetShortNotAtomic, addAndGetUnsignedByteNotAtomic, bytesForWrite, charAt, cipher, cipher, contentEquals, empty, endsWith, from, hash, inside, inside, isEmpty, length, nativePointer, startsWith, startsWith, subSequence, to8bitString, toDebugString, toDebugString, wrap, wrap, wrap, writeMaxInt, writeMaxLong, zeroOut

Methods inherited from interface net.openhft.chronicle.bytes.RandomDataOutput

append, append, write, write, writeBoolean, writeByte, writeInt24, writeOrderedDouble, writeOrderedFloat, writeUnsignedByte, writeUnsignedInt, writeUnsignedShort, writeUtf8, writeUtf8Limited, writeVolatileDouble, writeVolatileFloat

Methods inherited from interface java.lang.CharSequence

chars, codePoints

Methods inherited from interface net.openhft.chronicle.bytes.BytesIn

bytesMethodReader, bytesMethodReaderBuilder, readObject

Methods inherited from interface net.openhft.chronicle.bytes.RandomDataInput

addAndGetDouble, addAndGetFloat, addAndGetInt, addAndGetLong, compareUtf8, copyTo, copyTo, createCharToString, fastHash, findByte, parseLong, peekVolatileInt, printable, read, readBoolean, readIncompleteLong, readUnsignedInt, readUnsignedInt24, readUnsignedShort, readUtf8, readUtf8Limited, readUtf8Limited, readVolatileDouble, readVolatileFloat, subBytes, toByteArray

Methods inherited from interface net.openhft.chronicle.bytes.StreamingDataInput

inputStream, parseHexLong, parseUTF, parseUtf8, parseUtf8, rawReadByte, rawReadInt, rawReadLong, read, read, read, read, read, read8bit, read8bit, read8bit, read8bit, readBoolean, readChar, readEnum, readHistogram, readIncompleteLong, readInt24, readLimitToCapacity, readPositionRemaining, readPositionUnlimited, readStopBit, readStopBitChar, readStopBitDecimal, readStopBitDouble, readUnsignedInt, readUnsignedInt24, readUnsignedShort, readUtf8, readUtf8, readUtf8, readUtf8, readUTFΔ, readUTFΔ, readWithLength, readWithLength, readWithLength0, unsafeReadObject, unsafeReadObject

Methods inherited from interface net.openhft.chronicle.bytes.BytesOut

bytesMethodWriter, writeObject

Methods inherited from interface net.openhft.chronicle.bytes.ByteStringAppender

append, append, append, append, append, append, append, append, append8bit, append8bit, appendBase, appendBase16, appendBase16, appendDateMillis, appendDecimal, appendTimeMillis, writer

Methods inherited from interface net.openhft.chronicle.bytes.StreamingDataOutput

alignBy, appendUtf8, appendUtf8, appendUtf8, appendUtf8, copyFrom, outputStream, rawWriteByte, rawWriteInt, rawWriteLong, unsafeWriteObject, unsafeWriteObject, write, write, write, write, write8bit, write8bit, write8bit, writeBigDecimal, writeBigInteger, writeBoolean, writeChar, writeEnum, writeHistogram, writeInt24, writePositionRemaining, writeStopBit, writeStopBit, writeStopBit, writeStopBitDecimal, writeUnsignedByte, writeUnsignedInt, writeUnsignedInt24, writeUnsignedShort, writeUtf8, writeUtf8, writeUTFΔ, writeWithLength

Methods inherited from interface net.openhft.chronicle.bytes.BytesPrepender

prepend

Methods inherited from interface net.openhft.chronicle.bytes.BytesComment

comment, indent, retainsComments

Methods inherited from interface net.openhft.chronicle.core.io.ReferenceCountedTracer

onReleased, onReleased

Constructor Detail

NativeBytes

public NativeBytes(@NotNull
                   @NotNull BytesStore store,
                   long capacity)
            throws IllegalStateException,
                   IllegalArgumentException

Throws:

IllegalStateException

IllegalArgumentException

NativeBytes

public NativeBytes(@NotNull
                   @NotNull BytesStore store)
            throws IllegalStateException,
                   IllegalArgumentException

Throws:

IllegalStateException

IllegalArgumentException

Method Detail

areNewGuarded

public static boolean areNewGuarded()

For testing

Returns:

will new NativeBytes be guarded.

setNewGuarded

public static boolean setNewGuarded(boolean guarded)

turn guarding on/off. Can be enabled by assertion with assert NativeBytes.setNewGuarded(true);

Parameters:

guarded - turn on if true

resetNewGuarded

public static void resetNewGuarded()

For testing

nativeBytes

@NotNull
public static @NotNull NativeBytes<Void> nativeBytes()

nativeBytes

@NotNull
public static @NotNull NativeBytes<Void> nativeBytes(long initialCapacity)
                                                       throws IllegalArgumentException

Throws:

IllegalArgumentException

copyOf

public static BytesStore<Bytes<Void>,Void> copyOf(@NotNull
                                                  @NotNull Bytes bytes)
                                           throws IllegalStateException

Throws:

IllegalStateException

wrapWithNativeBytes

@NotNull
public static <T> @NotNull NativeBytes<T> wrapWithNativeBytes(@NotNull
                                                                       @NotNull BytesStore<?,T> bs,
                                                                       long capacity)
                                                                throws IllegalStateException,
                                                                       IllegalArgumentException

Throws:

IllegalStateException

IllegalArgumentException

maxCapacityFor

protected static <T> long maxCapacityFor(@NotNull
                                         @NotNull BytesStore<?,T> bs)

capacity

public long capacity()

Specified by:

capacity in interface BytesStore<Bytes<Underlying>,Underlying>

Overrides:

capacity in class AbstractBytes<Underlying>

Returns:

The maximum limit you can set.

writeCheckOffset

protected void writeCheckOffset(long offset,
                                long adding)
                         throws BufferOverflowException,
                                IllegalStateException

Throws:

BufferOverflowException

IllegalStateException

ensureCapacity

public void ensureCapacity(long desiredCapacity)
                    throws IllegalArgumentException,
                           IllegalStateException

Description copied from interface: Bytes

grow the buffer if the buffer is elastic, if the buffer is not elastic and there is not enough capacity then this method will throws BufferOverflowException

Parameters:

desiredCapacity - the capacity that you required

Throws:

IllegalArgumentException - if the buffer is not elastic and there is not enough space

IllegalStateException

isElastic

public boolean isElastic()

Description copied from interface: Bytes

Returns if this Bytes is elastic. I.e. it can resize when more data is written than it's Bytes.realCapacity().

Specified by:

isElastic in interface Bytes<Underlying>

Overrides:

isElastic in class VanillaBytes<Underlying>

Returns:

if this Bytes is elastic

isEqual

public boolean isEqual(long start,
                       long length,
                       String s)

bytesStore

protected void bytesStore(BytesStore<Bytes<Underlying>,Underlying> bytesStore)

Overrides:

bytesStore in class AbstractBytes<Underlying>

bytesStore

public void bytesStore(@NotNull
                       @NotNull BytesStore<Bytes<Underlying>,Underlying> byteStore,
                       long offset,
                       long length)
                throws IllegalStateException,
                       IllegalArgumentException,
                       BufferUnderflowException

Description copied from interface: Byteable

This setter for a data type which points to an underlying ByteStore.

Specified by:

bytesStore in interface Byteable<Bytes<Underlying>,Underlying>

Overrides:

bytesStore in class VanillaBytes<Underlying>

Parameters:

byteStore - the fix point ByteStore

offset - the offset within the ByteStore

length - the length in the ByteStore

Throws:

IllegalStateException

IllegalArgumentException

BufferUnderflowException

writeSome

@NotNull
public @NotNull NativeBytes writeSome(@NotNull
                                               @NotNull Bytes bytes)
                                        throws IllegalStateException

Throws:

IllegalStateException

writeOffsetPositionMoved

protected long writeOffsetPositionMoved(long adding,
                                        long advance)
                                 throws BufferOverflowException,
                                        IllegalStateException

Overrides:

writeOffsetPositionMoved in class AbstractBytes<Underlying>

Throws:

BufferOverflowException

IllegalStateException

writeByte

@NotNull
public @NotNull Bytes<Underlying> writeByte(byte i8)
                                              throws BufferOverflowException,
                                                     IllegalStateException

Specified by:

writeByte in interface StreamingDataOutput<Bytes<Underlying>>

Overrides:

writeByte in class AbstractBytes<Underlying>

Throws:

BufferOverflowException

IllegalStateException

writeLong

@NotNull
public @NotNull Bytes<Underlying> writeLong(long i64)
                                              throws BufferOverflowException,
                                                     IllegalStateException

Description copied from interface: StreamingDataOutput

Write a long

Specified by:

writeLong in interface StreamingDataOutput<Bytes<Underlying>>

Overrides:

writeLong in class AbstractBytes<Underlying>

Throws:

BufferOverflowException

IllegalStateException

readRemaining

public long readRemaining()

Returns:

How many more bytes can we read.

reader

@NotNull
public @NotNull Reader reader()

Access these bytes as an ISO-8859-1 encoded Reader

Returns:

as a Reader

parseBoolean

@Nullable
public @Nullable Boolean parseBoolean(@NotNull
                                                @NotNull StopCharTester tester)
                                         throws BufferUnderflowException,
                                                IllegalStateException,
                                                ArithmeticException

Return true or false, or null if it could not be detected as true or false. Case is not important

false: f, false, n, no, 0

true: t, true, y, yes, 1

Parameters:

tester - to detect the end of the text.

Returns:

true, false, or null if neither.

Throws:

BufferUnderflowException

IllegalStateException

ArithmeticException

parseBoolean

@Nullable
public @Nullable Boolean parseBoolean()
                                         throws BufferUnderflowException,
                                                IllegalStateException,
                                                ArithmeticException

Throws:

BufferUnderflowException

IllegalStateException

ArithmeticException

parseUtf8

@NotNull
public @NotNull String parseUtf8(@NotNull
                                          @NotNull StopCharTester stopCharTester)
                                   throws IllegalStateException,
                                          ArithmeticException

parse text with UTF-8 decoding as character terminated.

Parameters:

stopCharTester - to check if the end has been reached.

Returns:

the text as a String.

Throws:

IllegalStateException

ArithmeticException

parseUTF

@NotNull
 @Deprecated
public @NotNull String parseUTF(@NotNull
                                                      @NotNull StopCharTester stopCharTester)
                                               throws IllegalStateException,
                                                      ArithmeticException

Deprecated.

Throws:

IllegalStateException

ArithmeticException

parseUtf8

public void parseUtf8(@NotNull
                      @NotNull Appendable buffer,
                      @NotNull
                      @NotNull StopCharTester stopCharTester)
               throws BufferUnderflowException,
                      IllegalStateException,
                      ArithmeticException

parse text with UTF-8 decoding as character terminated.

Parameters:

buffer - to populate

stopCharTester - to check if the end has been reached.

Throws:

BufferUnderflowException

IllegalStateException

ArithmeticException

parseUTF

@Deprecated
public void parseUTF(@NotNull
                                 @NotNull Appendable buffer,
                                 @NotNull
                                 @NotNull StopCharTester stopCharTester)
                          throws BufferUnderflowException,
                                 IllegalStateException,
                                 ArithmeticException

Deprecated.

Throws:

BufferUnderflowException

IllegalStateException

ArithmeticException

parseUtf8

public void parseUtf8(@NotNull
                      @NotNull Appendable buffer,
                      @NotNull
                      @NotNull StopCharsTester stopCharsTester)
               throws BufferUnderflowException,
                      net.openhft.chronicle.core.io.IORuntimeException,
                      IllegalStateException

parse text with UTF-8 decoding as one or two character terminated.

Parameters:

buffer - to populate

stopCharsTester - to check if the end has been reached.

Throws:

BufferUnderflowException

net.openhft.chronicle.core.io.IORuntimeException

IllegalStateException

parseUTF

@Deprecated
public void parseUTF(@NotNull
                                 @NotNull Appendable buffer,
                                 @NotNull
                                 @NotNull StopCharsTester stopCharsTester)
                          throws BufferUnderflowException,
                                 net.openhft.chronicle.core.io.IORuntimeException,
                                 IllegalStateException

Deprecated.

Throws:

BufferUnderflowException

net.openhft.chronicle.core.io.IORuntimeException

IllegalStateException

parse8bit

public void parse8bit(Appendable buffer,
                      @NotNull
                      @NotNull StopCharTester stopCharTester)
               throws BufferUnderflowException,
                      BufferOverflowException,
                      IllegalStateException,
                      ArithmeticException

parse text with ISO-8859-1 decoding as character terminated.

Parameters:

buffer - to populate

stopCharTester - to check if the end has been reached.

Throws:

BufferUnderflowException

BufferOverflowException

IllegalStateException

ArithmeticException

parse8bit

public String parse8bit(@NotNull
                        @NotNull StopCharTester stopCharTester)
                 throws BufferUnderflowException,
                        IllegalStateException

parse text with ISO-8859-1 decoding as character terminated.

Parameters:

stopCharTester - to check if the end has been reached.

Throws:

BufferUnderflowException

IllegalStateException

parse8bit

public void parse8bit(Appendable buffer,
                      @NotNull
                      @NotNull StopCharsTester stopCharsTester)
               throws BufferUnderflowException,
                      BufferOverflowException,
                      IllegalStateException,
                      ArithmeticException

parse text with ISO-8859-1 decoding as character terminated.

Parameters:

buffer - to populate

stopCharsTester - to check if the end has been reached.

Throws:

BufferUnderflowException

BufferOverflowException

IllegalStateException

ArithmeticException

parse8bit

public void parse8bit(Bytes buffer,
                      @NotNull
                      @NotNull StopCharsTester stopCharsTester)
               throws BufferUnderflowException,
                      BufferOverflowException,
                      IllegalStateException,
                      ArithmeticException

Throws:

BufferUnderflowException

BufferOverflowException

IllegalStateException

ArithmeticException

parse8bit

public void parse8bit(StringBuilder buffer,
                      @NotNull
                      @NotNull StopCharsTester stopCharsTester)
               throws IllegalStateException

Throws:

IllegalStateException

parseInt

public int parseInt()
             throws BufferUnderflowException,
                    ArithmeticException,
                    IllegalStateException

parse text as an int. The terminating character is consumed.

Returns:

an int.

Throws:

BufferUnderflowException

ArithmeticException

IllegalStateException

parseLong

public long parseLong()
               throws BufferUnderflowException,
                      IllegalStateException

parse text as a long integer. The terminating character is consumed.

Returns:

a long.

Throws:

BufferUnderflowException

IllegalStateException

parseFloat

public float parseFloat()
                 throws BufferUnderflowException,
                        IllegalStateException

parse text as a float decimal. The terminating character is consumed.

The number of decimal places can be retrieved with lastDecimalPlaces()

Returns:

a float.

Throws:

BufferUnderflowException

IllegalStateException

parseDouble

public double parseDouble()
                   throws BufferUnderflowException,
                          IllegalStateException

parse text as a double decimal. The terminating character is consumed.

The number of decimal places can be retrieved with lastDecimalPlaces()

Returns:

a double.

Throws:

BufferUnderflowException

IllegalStateException

parseLongDecimal

public long parseLongDecimal()
                      throws BufferUnderflowException,
                             IllegalStateException

Parse the significant digits of a decimal number.

The number of decimal places can be retrieved with lastDecimalPlaces()

Returns:

the significant digits

Throws:

BufferUnderflowException

IllegalStateException

skipTo

public boolean skipTo(@NotNull
                      @NotNull StopCharTester tester)
               throws IllegalStateException

Skip text until a terminating character is reached.

Parameters:

tester - to stop at

Returns:

true if a terminating character was found, false if the end of the buffer was reached.

Throws:

IllegalStateException

parseBigDecimal

@NotNull
public @NotNull BigDecimal parseBigDecimal()
                                             throws IllegalStateException,
                                                    ArithmeticException

Throws:

IllegalStateException

ArithmeticException