public interface Bytes<Underlying> extends BytesStore<Bytes<Underlying>,Underlying>, BytesIn<Underlying>, BytesOut<Underlying>
| Modifier and Type | Field and Description |
|---|---|
static int |
DEFAULT_BYTE_BUFFER_CAPACITY |
static long |
MAX_CAPACITY |
charToString| Modifier and Type | Method and Description |
|---|---|
static Bytes |
allocateDirect(byte[] bytes)
copies the contents of bytes into a direct byte buffer
|
static VanillaBytes<Void> |
allocateDirect(long capacity)
Allocate a fixed size buffer read for writing.
|
static NativeBytes<Void> |
allocateElasticDirect()
Allocate an elastic buffer with initially no size.
|
static NativeBytes<Void> |
allocateElasticDirect(long initialCapacity)
Allocate an elastic buffer with initially no size.
|
default Bytes<Underlying> |
bytesForRead()
Creates a slice of the current Bytes based on its position() and limit().
|
BytesStore |
bytesStore() |
Bytes<Underlying> |
compact()
Compact these Bytes by moving the readPosition to the start.
|
BytesStore<Bytes<Underlying>,Underlying> |
copy() |
default long |
copyTo(BytesStore store)
Copy the data to another BytesStore
|
default void |
copyTo(OutputStream out) |
static Bytes<ByteBuffer> |
elasticByteBuffer() |
static Bytes<ByteBuffer> |
elasticByteBuffer(int initialCapacity)
Returns an elastic wrapper for a direct ByteBuffer which will be resized as required, with
the given initial capacity.
|
static Bytes<ByteBuffer> |
elasticByteBuffer(int initialCapacity,
int maxSize) |
default void |
ensureCapacity(long size)
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 |
static <B extends BytesStore<B,Underlying>,Underlying> |
expect(BytesStore<B,Underlying> bytesStore)
A Bytes suitable for writing to for testing purposes.
|
static Bytes<byte[]> |
expect(String text)
A Bytes suitable for writing to for testing purposes.
|
static Bytes<byte[]> |
from(CharSequence text)
Convert text to bytes using ISO-8859-1 encoding and return a Bytes ready for reading.
|
static Bytes |
fromHexString(String s) |
default boolean |
isClear()
The Bytes are clear if start() == readPosition() && writeLimit() == capacity()
|
boolean |
isElastic() |
default boolean |
isEmpty() |
default boolean |
isEqual(String s) |
int |
lastDecimalPlaces() |
void |
lastDecimalPlaces(int lastDecimalPlaces)
Store the last number of decimal places.
|
default void |
parse8bit(Appendable buffer,
StopCharsTester stopCharsTester)
parse text with ISO-8859-1 decoding as character terminated.
|
default void |
parse8bit(Appendable buffer,
StopCharTester stopCharTester)
parse text with ISO-8859-1 decoding as character terminated.
|
default Boolean |
parseBoolean(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 long |
parseLong()
parse text as a long integer.
|
default long |
parseLongDecimal()
Parse the significant digits of a decimal number.
|
default void |
parseUTF(Appendable buffer,
StopCharsTester stopCharsTester)
Deprecated.
|
default void |
parseUTF(Appendable buffer,
StopCharTester stopCharTester)
Deprecated.
|
default String |
parseUTF(StopCharTester stopCharTester)
Deprecated.
|
default void |
parseUtf8(Appendable buffer,
StopCharsTester stopCharsTester)
parse text with UTF-8 decoding as one or two character terminated.
|
default void |
parseUtf8(Appendable buffer,
StopCharTester stopCharTester)
parse text with UTF-8 decoding as character terminated.
|
default String |
parseUtf8(StopCharTester stopCharTester)
parse text with UTF-8 decoding as character terminated.
|
default Reader |
reader()
Access these bytes as an ISO-8859-1 encoded Reader
|
default long |
realCapacity() |
default long |
safeLimit() |
default boolean |
sharedMemory() |
default boolean |
skipTo(StopCharTester tester)
Skip text until a terminating character is reached.
|
default String |
toHexString()
display the hex data of
Bytes from the position() to the limit() |
default String |
toHexString(long maxLength)
display the hex data of
Bytes from the position() to the limit() |
default String |
toHexString(long offset,
long maxLength)
display the hex data of
Bytes from the position() to the limit() |
static String |
toString(Bytes<?> buffer)
Creates a string from the
position to the limit, The buffer is not modified
by this call |
static String |
toString(Bytes<?> buffer,
long maxLen)
Creates a string from the
position to the limit, The buffer is not modified
by this call |
static String |
toString(Bytes buffer,
long position,
long len)
The buffer is not modified by this call
|
default Bytes<Underlying> |
unchecked(boolean unchecked)
Return a Bytes which is optionally unchecked.
|
static Bytes<byte[]> |
wrapForRead(byte[] byteArray)
Wrap the byte[] ready for reading
|
static Bytes<ByteBuffer> |
wrapForRead(ByteBuffer byteBuffer) |
static Bytes<byte[]> |
wrapForRead(CharSequence text)
Deprecated.
|
static Bytes<byte[]> |
wrapForWrite(byte[] byteArray)
Wrap the byte[] ready for writing
|
static Bytes<ByteBuffer> |
wrapForWrite(ByteBuffer byteBuffer) |
addAndGetByteNotAtomic, addAndGetDoubleNotAtomic, addAndGetFloatNotAtomic, addAndGetIntNotAtomic, addAndGetLongNotAtomic, addAndGetShortNotAtomic, addAndGetUnsignedByteNotAtomic, addAndGetUnsignedIntNotAtomic, addAndGetUnsignedShortNotAtomic, byteCheckSum, bytesForWrite, capacity, charAt, contentEquals, empty, endsWith, equalBytes, inside, isNative, isPresent, isPresent, length, longCheckSum, move, nativePointer, startsWith, startsWith, subSequence, to8bitString, toDebugString, toDebugString, underlyingObject, wrap, wrap, wrap, wrap, writeMaxLong, zeroOutaddAndGetDouble, addAndGetFloat, addAndGetInt, addAndGetLong, compareUtf8, copyTo, copyTo, createCharToString, fastHash, findByte, nativeRead, parseLong, printable, read, readBoolean, readByte, readDouble, readFloat, readIncompleteLong, readInt, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedInt24, readUnsignedShort, readUtf8, readUtf8Limited, readUtf8Limited, readVolatileByte, readVolatileDouble, readVolatileFloat, readVolatileInt, readVolatileLong, readVolatileShort, subBytes, toByteArray, toTemporaryDirectByteBufferappend, nativeWrite, write, write, write, write, write, writeBoolean, writeByte, writeByte, writeDouble, writeFloat, writeInt, writeInt24, writeLong, writeOrderedDouble, writeOrderedFloat, writeOrderedInt, writeOrderedLong, writeShort, writeUnsignedByte, writeUnsignedInt, writeUnsignedShort, writeUtf8, writeUtf8Limited, writeVolatileByte, writeVolatileDouble, writeVolatileFloat, writeVolatileInt, writeVolatileLong, writeVolatileShortchars, codePoints, toStringinputStream, nativeRead, parseHexLong, parseUTF, parseUtf8, parseWithLength, peekUnsignedByte, read, read, read, read, read8bit, read8bit, read8bit, read8bit, readBoolean, readByte, readDouble, readEnum, readFloat, readInt, readLimit, readLong, readPosition, readPositionRemaining, readShort, readSkip, readStopBit, readStopBitDouble, readUnsignedByte, readUnsignedInt, readUnsignedInt24, readUnsignedShort, readUtf8, readUtf8, readUTFΔ, readUTFΔ, readVolatileInt, readVolatileLong, readWithLengthappend, append, append, append, append, append, append, append8bit, append8bit, append8bit, appendBase, appendDateMillis, appendDecimal, appendTimeMillis, writerappendUtf8, appendUtf8, appendUtf8, appendUtf8, copyFrom, nativeWrite, outputStream, write, write, write, write, write, write, write8bit, write8bit, write8bit, write8bit, writeBoolean, writeByte, writeDouble, writeEnum, writeFloat, writeInt, writeInt24, writeLimit, writeLong, writeOrderedInt, writeOrderedLong, writePosition, writePositionRemaining, writeShort, writeSkip, writeSome, writeSome, writeStopBit, writeStopBit, writeUnsignedByte, writeUnsignedInt, writeUnsignedShort, writeUtf8, writeUtf8, writeUTFΔclearAndPad, prepend, prewrite, prewrite, prewriteByte, prewriteInt, prewriteLong, prewriteShortstatic final long MAX_CAPACITY
static final int DEFAULT_BYTE_BUFFER_CAPACITY
static Bytes<ByteBuffer> elasticByteBuffer()
static Bytes<ByteBuffer> elasticByteBuffer(int initialCapacity, int maxSize)
static Bytes<ByteBuffer> elasticByteBuffer(int initialCapacity)
static Bytes<ByteBuffer> wrapForRead(ByteBuffer byteBuffer)
byteBuffer - to readstatic Bytes<ByteBuffer> wrapForWrite(ByteBuffer byteBuffer)
byteBuffer - to read@NotNull static Bytes<byte[]> expect(@NotNull String text)
text - expected@NotNull static <B extends BytesStore<B,Underlying>,Underlying> Bytes<Underlying> expect(BytesStore<B,Underlying> bytesStore)
bytesStore - expectedstatic Bytes<byte[]> wrapForRead(byte[] byteArray)
byteArray - to wrapstatic Bytes<byte[]> wrapForWrite(byte[] byteArray)
byteArray - to wrapstatic Bytes<byte[]> from(@NotNull CharSequence text) throws IllegalArgumentException, IllegalStateException
from in interface BytesStore<Bytes<Underlying>,Underlying>text - to convertIllegalArgumentExceptionIllegalStateException@Deprecated static Bytes<byte[]> wrapForRead(@NotNull CharSequence text) throws IllegalArgumentException, IllegalStateException
static VanillaBytes<Void> allocateDirect(long capacity) throws IllegalArgumentException
capacity - minimum to allocateIllegalArgumentExceptionstatic NativeBytes<Void> allocateElasticDirect()
static NativeBytes<Void> allocateElasticDirect(long initialCapacity) throws IllegalArgumentException
IllegalArgumentExceptionstatic String toString(@NotNull Bytes<?> buffer) throws BufferUnderflowException
position to the limit, The buffer is not modified
by this callbuffer - the buffer to useposition to the limitBufferUnderflowExceptionstatic String toString(@NotNull Bytes<?> buffer, long maxLen) throws BufferUnderflowException
position to the limit, The buffer is not modified
by this callbuffer - the buffer to usemaxLen - of the result returnedposition to the limitBufferUnderflowExceptionstatic String toString(@NotNull Bytes buffer, long position, long len) throws BufferUnderflowException, net.openhft.chronicle.core.io.IORuntimeException
buffer - the buffer to useposition - the position to create the string fromlen - the number of characters to show in the stringpositionBufferUnderflowExceptionnet.openhft.chronicle.core.io.IORuntimeExceptionstatic Bytes allocateDirect(@NotNull byte[] bytes) throws IllegalArgumentException
bytes - the bytes to wrapbytesIllegalArgumentExceptiondefault Bytes<Underlying> unchecked(boolean unchecked) throws IllegalStateException
unchecked - if true, minimal bounds checks will be performed.IllegalStateException - if the underlying BytesStore has been releaseddefault long safeLimit()
safeLimit in interface BytesStore<Bytes<Underlying>,Underlying>default boolean isClear()
BytesStoreisClear in interface BytesStore<Bytes<Underlying>,Underlying>default long realCapacity()
realCapacity in interface BytesStore<Bytes<Underlying>,Underlying>realCapacity in interface RandomDataInputBytesStore<Bytes<Underlying>,Underlying> copy()
copy in interface BytesStore<Bytes<Underlying>,Underlying>@NotNull default String toHexString() throws net.openhft.chronicle.core.io.IORuntimeException
Bytes from the position() to the limit()net.openhft.chronicle.core.io.IORuntimeException@NotNull default String toHexString(long maxLength) throws net.openhft.chronicle.core.io.IORuntimeException
Bytes from the position() to the limit()maxLength - limit the number of bytes to be dumped.net.openhft.chronicle.core.io.IORuntimeException@NotNull default String toHexString(long offset, long maxLength) throws net.openhft.chronicle.core.io.IORuntimeException
Bytes from the position() to the limit()maxLength - limit the number of bytes to be dumped.net.openhft.chronicle.core.io.IORuntimeExceptionboolean isElastic()
default void ensureCapacity(long size)
throws IllegalArgumentException,
net.openhft.chronicle.core.io.IORuntimeException
BufferOverflowExceptionsize - the capacity that you requiredIllegalArgumentException - if the buffer is not elastic and there is not enough spaceIORuntimeException - if an error occured trying to resize the underlying buffer.net.openhft.chronicle.core.io.IORuntimeExceptiondefault Bytes<Underlying> bytesForRead() throws IllegalStateException
bytesForRead in interface BytesStore<Bytes<Underlying>,Underlying>IllegalStateException - if the underlying BytesStore has been releasedBytesStore bytesStore()
bytesStore in interface BytesStore<Bytes<Underlying>,Underlying>default boolean isEqual(String s)
default boolean isEmpty()
Bytes<Underlying> compact()
default long copyTo(@NotNull
BytesStore store)
BytesStorecopyTo in interface BytesStore<Bytes<Underlying>,Underlying>copyTo in interface StreamingDataInput<Bytes<Underlying>>store - to copy todefault void copyTo(OutputStream out) throws IOException
copyTo in interface BytesStore<Bytes<Underlying>,Underlying>copyTo in interface StreamingDataInput<Bytes<Underlying>>IOExceptiondefault boolean sharedMemory()
default Reader reader()
default Boolean parseBoolean(@NotNull StopCharTester tester)
false: f, false, n, no, 0
true: t, true, y, yes, 1
tester - to detect the end of the text.@NotNull default String parseUtf8(@NotNull StopCharTester stopCharTester)
stopCharTester - to check if the end has been reached.@Deprecated default String parseUTF(@NotNull StopCharTester stopCharTester)
default void parseUtf8(@NotNull
Appendable buffer,
@NotNull
StopCharTester stopCharTester)
buffer - to populatestopCharTester - to check if the end has been reached.@Deprecated default void parseUTF(@NotNull Appendable buffer, @NotNull StopCharTester stopCharTester)
default void parseUtf8(@NotNull
Appendable buffer,
@NotNull
StopCharsTester stopCharsTester)
throws BufferUnderflowException,
BufferOverflowException,
net.openhft.chronicle.core.io.IORuntimeException
buffer - to populatestopCharsTester - to check if the end has been reached.BufferUnderflowExceptionBufferOverflowExceptionnet.openhft.chronicle.core.io.IORuntimeException@Deprecated default void parseUTF(@NotNull Appendable buffer, @NotNull StopCharsTester stopCharsTester) throws BufferUnderflowException, BufferOverflowException, net.openhft.chronicle.core.io.IORuntimeException
BufferUnderflowExceptionBufferOverflowExceptionnet.openhft.chronicle.core.io.IORuntimeExceptiondefault void parse8bit(Appendable buffer, @NotNull StopCharTester stopCharTester) throws BufferUnderflowException, BufferOverflowException, net.openhft.chronicle.core.io.IORuntimeException
buffer - to populatestopCharTester - to check if the end has been reached.BufferUnderflowExceptionBufferOverflowExceptionnet.openhft.chronicle.core.io.IORuntimeExceptiondefault void parse8bit(Appendable buffer, @NotNull StopCharsTester stopCharsTester) throws BufferUnderflowException, BufferOverflowException, net.openhft.chronicle.core.io.IORuntimeException
buffer - to populatestopCharsTester - to check if the end has been reached.BufferUnderflowExceptionBufferOverflowExceptionnet.openhft.chronicle.core.io.IORuntimeExceptiondefault long parseLong()
throws BufferUnderflowException,
net.openhft.chronicle.core.io.IORuntimeException
BufferUnderflowExceptionnet.openhft.chronicle.core.io.IORuntimeExceptiondefault double parseDouble()
throws BufferUnderflowException,
net.openhft.chronicle.core.io.IORuntimeException
The number of decimal places can be retrieved with lastDecimalPlaces()
BufferUnderflowExceptionnet.openhft.chronicle.core.io.IORuntimeExceptiondefault long parseLongDecimal()
throws BufferUnderflowException
The number of decimal places can be retrieved with lastDecimalPlaces()
BufferUnderflowExceptionint lastDecimalPlaces()
void lastDecimalPlaces(int lastDecimalPlaces)
lastDecimalPlaces - set the number of decimal places if positive, otherwise 0.default boolean skipTo(@NotNull
StopCharTester tester)
throws net.openhft.chronicle.core.io.IORuntimeException
tester - to stop atnet.openhft.chronicle.core.io.IORuntimeExceptionCopyright © 2016. All rights reserved.