net.openhft.chronicle.bytes

Interface RandomDataInput

All Known Subinterfaces:

Bytes<U>, BytesIn<U>, BytesStore<B,U>

All Known Implementing Classes:

AbstractBytes, AbstractBytesStore, ChunkedMappedBytes, CommonMappedBytes, EmbeddedBytes, GuardedNativeBytes, HeapBytesStore, HexDumpBytes, MappedBytes, MappedBytesStore, NativeBytes, NativeBytesStore, NoBytesStore, OnHeapBytes, PointerBytesStore, SingleMappedBytes, SubBytes, UncheckedBytes, UncheckedNativeBytes, VanillaBytes

public interface RandomDataInput

This allows random access to the underling bytes. This instance can be used across threads as it is stateless. The thread safety of the underlying data depends on how the methods are used.

Field Summary

Fields

Modifier and Type	Field and Description
static String[]	charToString

Fields inherited from interface net.openhft.chronicle.core.io.ReferenceOwner

INIT, TMP

Method Summary

Modifier and Type	Method and Description
default double	addAndGetDouble(long offset, double adding) Deprecated.
default float	addAndGetFloat(long offset, float adding) Deprecated.
default int	addAndGetInt(long offset, int adding) Deprecated.
default long	addAndGetLong(long offset, long adding) Deprecated.
long	addressForRead(long offset) Obtain the underlying addressForRead.
default long	addressForRead(long offset, int buffer)
long	addressForWrite(long offset) Obtain the underlying addressForRead.
long	addressForWritePosition()
default ByteOrder	byteOrder()
@NotNull Bytes<?>	bytesForRead()
@NotNull Bytes<?>	bytesForWrite()
default boolean	canReadDirect()
default boolean	canReadDirect(long length)
default long	capacity()
default boolean	compareAndSwapDouble(long offset, double expected, double value) Deprecated.
default boolean	compareAndSwapFloat(long offset, float expected, float value) Deprecated.
boolean	compareAndSwapInt(long offset, int expected, int value) Deprecated.
boolean	compareAndSwapLong(long offset, long expected, long value) Deprecated.
default boolean	compareUtf8(long offset, @Nullable CharSequence other) Compares the UTF-8 encoded char sequence, written in this RandomDataInput at the given offset, with the given char sequence.
default int	copyTo(byte[] bytes) Read a byte[] from memory from RandomCommon.readPosition() to RandomCommon.readLimit().
default int	copyTo(@NotNull ByteBuffer bb) Copy data from this RandomDataInput to the ByteBuffer.
static @NotNull String[]	createCharToString()
default int	fastHash(long offset, int length)
default long	findByte(byte stopByte)
boolean	isDirectMemory()
default long	lengthWritten(long startPosition) Typically this calculates the difference however for HexDumpBytes it's not as simple.
void	nativeRead(long position, long address, long size) expert level method for copying data to native memory.
default long	parseLong(long offset)
int	peekUnsignedByte(long offset) Read an unsigned byte at an offset, or -1
default int	peekVolatileInt()
default String	printable(long offset) Read the byte at an offset and converts it into a printable
default long	read(long offsetInRDI, byte[] bytes, int offset, int length)
default boolean	readBoolean(long offset) Read boolean at an offset
byte	readByte(long offset) Read byte at an offset
double	readDouble(long offset) Read a double at an offset
float	readFloat(long offset) Read a float at an offset
default long	readIncompleteLong(long offset) Read a long which is zero padded (high bytes) if the available bytes is less than 8.
int	readInt(long offset) Read an int at an offset
default long	readLimit() If the resource is closed, the returned value is unspecified.
long	readLong(long offset) Read a long at an offset
default long	readPosition() Returns the read position.
default long	readRemaining() Returns the remaining bytes that can be read.
short	readShort(long offset) Read a short at an offset
default int	readUnsignedByte(long offset) Read an unsigned byte at an offset
default long	readUnsignedInt(long offset) Read an unsigned int at an offset
default int	readUnsignedInt24(long offset) Read an unsigned int at an offset
default int	readUnsignedShort(long offset) Read an unsigned short at an offset
default <T extends Appendable & CharSequence> long	readUtf8(long offset, T sb) Truncates sb (it must be a StringBuilder or Bytes) and reads a char sequence from the given offset, encoded as Utf8, into it.
default @Nullable String	readUtf8Limited(long offset, int maxUtf8Len) Reads a char sequence from the given offset, encoded as Utf8.
default <T extends Appendable & CharSequence> long	readUtf8Limited(long offset, T sb, int maxUtf8Len) Truncates sb (it must be a StringBuilder or Bytes) and reads a char sequence from the given offset, encoded as Utf8, into it.
byte	readVolatileByte(long offset) Read a 8-bit byte from memory with a load barrier.
default double	readVolatileDouble(long offset) Read a 64-bit double from memory with a load barrier.
default float	readVolatileFloat(long offset) Read a float from memory with a load barrier.
int	readVolatileInt(long offset) Read a 32-bit int from memory with a load barrier.
long	readVolatileLong(long offset) Read a 64-bit long from memory with a load barrier.
short	readVolatileShort(long offset) Read a 16-bit short from memory with a load barrier.
long	realCapacity() Returns the actual capacity that can be potentially read.
default long	realReadRemaining() If the resource is closed, the returned value is unspecified.
default long	realWriteRemaining() If the resource is closed, the returned value is unspecified.
boolean	sharedMemory()
default long	start()
default @NotNull BytesStore	subBytes(long start, long length) Copy a sub sequence of bytes as a BytesStore.
void	testAndSetInt(long offset, int expected, int value) Deprecated.
default byte[]	toByteArray()
default ByteBuffer	toTemporaryDirectByteBuffer()
default long	writeLimit() Returns the write limit.
default long	writePosition() Returns the write position.
default long	writeRemaining() If the resource is closed, the returned value is unspecified.

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

addReferenceChangeListener, refCount, release, releaseLast, releaseLast, removeReferenceChangeListener, reserve, reservedBy, reserveTransfer, tryReserve

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

referenceId, referenceName, temporary

Field Detail

charToString

static final String[] charToString

Method Detail

createCharToString

@NotNull
static @NotNull String[] createCharToString()

peekVolatileInt

default int peekVolatileInt()
                     throws BufferUnderflowException,
                            IllegalStateException

Throws:

BufferUnderflowException

IllegalStateException

readBoolean

default boolean readBoolean(long offset)
                     throws BufferUnderflowException,
                            IllegalStateException

Read boolean at an offset

Parameters:

offset - to read

Returns:

the boolean

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readByte

byte readByte(long offset)
       throws BufferUnderflowException,
              IllegalStateException

Read byte at an offset

Parameters:

offset - to read

Returns:

the byte

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readUnsignedByte

default int readUnsignedByte(long offset)
                      throws BufferUnderflowException,
                             IllegalStateException

Read an unsigned byte at an offset

Parameters:

offset - to read

Returns:

the unsigned byte

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

peekUnsignedByte

int peekUnsignedByte(long offset)
              throws IllegalStateException

Read an unsigned byte at an offset, or -1

Parameters:

offset - to read

Returns:

the unsigned byte or -1

Throws:

IllegalStateException - if released

readShort

short readShort(long offset)
         throws BufferUnderflowException,
                IllegalStateException

Read a short at an offset

Parameters:

offset - to read

Returns:

the short

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readUnsignedShort

default int readUnsignedShort(long offset)
                       throws BufferUnderflowException,
                              IllegalStateException

Read an unsigned short at an offset

Parameters:

offset - to read

Returns:

the unsigned short

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readUnsignedInt24

default int readUnsignedInt24(long offset)
                       throws BufferUnderflowException,
                              IllegalStateException

Read an unsigned int at an offset

Parameters:

offset - to read

Returns:

the int

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readInt

int readInt(long offset)
     throws BufferUnderflowException,
            IllegalStateException

Read an int at an offset

Parameters:

offset - to read

Returns:

the int

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readUnsignedInt

default long readUnsignedInt(long offset)
                      throws BufferUnderflowException,
                             IllegalStateException

Read an unsigned int at an offset

Parameters:

offset - to read

Returns:

the unsigned int

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readLong

long readLong(long offset)
       throws BufferUnderflowException,
              IllegalStateException

Read a long at an offset

Parameters:

offset - to read

Returns:

the long

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readFloat

float readFloat(long offset)
         throws BufferUnderflowException,
                IllegalStateException

Read a float at an offset

Parameters:

offset - to read

Returns:

the float

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readDouble

double readDouble(long offset)
           throws BufferUnderflowException,
                  IllegalStateException

Read a double at an offset

Parameters:

offset - to read

Returns:

the double

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

printable

default String printable(long offset)
                  throws BufferUnderflowException,
                         IllegalStateException

Read the byte at an offset and converts it into a printable

Parameters:

offset - to read

Returns:

the byte in a printable form.

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readVolatileByte

byte readVolatileByte(long offset)
               throws BufferUnderflowException,
                      IllegalStateException

Read a 8-bit byte from memory with a load barrier.

Parameters:

offset - to read

Returns:

the byte value

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readVolatileShort

short readVolatileShort(long offset)
                 throws BufferUnderflowException,
                        IllegalStateException

Read a 16-bit short from memory with a load barrier.

Parameters:

offset - to read

Returns:

the short value

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readVolatileInt

int readVolatileInt(long offset)
             throws BufferUnderflowException,
                    IllegalStateException

Read a 32-bit int from memory with a load barrier.

Parameters:

offset - to read

Returns:

the int value

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readVolatileFloat

default float readVolatileFloat(long offset)
                         throws BufferUnderflowException,
                                IllegalStateException

Read a float from memory with a load barrier.

Parameters:

offset - to read

Returns:

the float value

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readVolatileLong

long readVolatileLong(long offset)
               throws BufferUnderflowException,
                      IllegalStateException

Read a 64-bit long from memory with a load barrier.

Parameters:

offset - to read

Returns:

the long value

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

readVolatileDouble

default double readVolatileDouble(long offset)
                           throws BufferUnderflowException,
                                  IllegalStateException

Read a 64-bit double from memory with a load barrier.

Parameters:

offset - to read

Returns:

the double value

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

parseLong

default long parseLong(long offset)
                throws BufferUnderflowException,
                       IllegalStateException

Throws:

BufferUnderflowException

IllegalStateException

nativeRead

void nativeRead(long position,
                long address,
                long size)
         throws BufferUnderflowException,
                IllegalStateException

expert level method for copying data to native memory.

Parameters:

position - within the ByteStore to copy.

address - in native memory

size - in bytes

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

copyTo

default int copyTo(byte[] bytes)
            throws BufferUnderflowException,
                   IllegalStateException

Read a byte[] from memory from RandomCommon.readPosition() to RandomCommon.readLimit().

Returns:

the length actually read.

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

copyTo

default int copyTo(@NotNull
                   @NotNull ByteBuffer bb)
            throws BufferUnderflowException,
                   IllegalStateException

Copy data from this RandomDataInput to the ByteBuffer. The minimum of readRemaining() and Buffer.remaining(). Starting from start() in this RandomDataInput and from Buffer.position() of the given bb. Does NOT change the position or limit or mark of the given ByteBuffer. Returns the number of the copied bytes.

Throws:

IllegalStateException - if released

BufferUnderflowException

readIncompleteLong

default long readIncompleteLong(long offset)
                         throws IllegalStateException

Read a long which is zero padded (high bytes) if the available bytes is less than 8. If the offset is at or beyond the readLimit, this will return 0L.

Parameters:

offset - to read from

Returns:

the long which might be padded.

Throws:

IllegalStateException - if released

realCapacity

long realCapacity()

Returns the actual capacity that can be potentially read.

Returns:

the actual capacity that can be potentially read.

addAndGetInt

@Deprecated
default int addAndGetInt(long offset,
                                     int adding)
                              throws BufferUnderflowException,
                                     IllegalStateException

Deprecated.

Perform an atomic add and get operation for a 32-bit int

Parameters:

offset - to add and get

adding - value to add, can be 1

Returns:

the sum

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

addAndGetLong

@Deprecated
default long addAndGetLong(long offset,
                                       long adding)
                                throws BufferUnderflowException,
                                       IllegalStateException

Deprecated.

Perform an atomic add and get operation for a 64-bit long

Parameters:

offset - to add and get

adding - value to add, can be 1

Returns:

the sum

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

addAndGetFloat

@Deprecated
default float addAndGetFloat(long offset,
                                         float adding)
                                  throws BufferUnderflowException,
                                         IllegalStateException

Deprecated.

Perform an atomic add and get operation for a 32-bit float

Parameters:

offset - to add and get

adding - value to add, can be 1

Returns:

the sum

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException

addAndGetDouble

@Deprecated
default double addAndGetDouble(long offset,
                                           double adding)
                                    throws BufferUnderflowException,
                                           IllegalStateException

Deprecated.

Perform an atomic add and get operation for a 64-bit double

Parameters:

offset - to add and get

adding - value to add, can be 1

Returns:

the sum

Throws:

BufferUnderflowException - if the offset is outside the limits of the Bytes

IllegalStateException - if released

compareAndSwapInt

@Deprecated
boolean compareAndSwapInt(long offset,
                                      int expected,
                                      int value)
                               throws BufferOverflowException,
                                      IllegalStateException

Deprecated.

Perform a 32-bit CAS at a given offset.

Parameters:

offset - to perform CAS

expected - value

value - to set

Returns:

true, if successful.

Throws:

BufferOverflowException

IllegalStateException

testAndSetInt

@Deprecated
void testAndSetInt(long offset,
                               int expected,
                               int value)
                        throws BufferOverflowException,
                               IllegalStateException

Deprecated.

Throws:

BufferOverflowException

IllegalStateException

compareAndSwapLong

@Deprecated
boolean compareAndSwapLong(long offset,
                                       long expected,
                                       long value)
                                throws BufferOverflowException,
                                       IllegalStateException

Deprecated.

Perform a 64-bit CAS at a given offset.

Parameters:

offset - to perform CAS

expected - value

value - to set

Returns:

true, if successful.

Throws:

BufferOverflowException

IllegalStateException

compareAndSwapFloat

@Deprecated
default boolean compareAndSwapFloat(long offset,
                                                float expected,
                                                float value)
                                         throws BufferOverflowException,
                                                IllegalStateException

Deprecated.

Perform a 32-bit float CAS at a given offset.

Parameters:

offset - to perform CAS

expected - value

value - to set

Returns:

true, if successful.

Throws:

BufferOverflowException

IllegalStateException

compareAndSwapDouble

@Deprecated
default boolean compareAndSwapDouble(long offset,
                                                 double expected,
                                                 double value)
                                          throws BufferOverflowException,
                                                 IllegalStateException

Deprecated.

Perform a 64-bit double CAS at a given offset.

Parameters:

offset - to perform CAS

expected - value

value - to set

Returns:

true, if successful.

Throws:

BufferOverflowException

IllegalStateException

subBytes

@NotNull
default @NotNull BytesStore subBytes(long start,
                                              long length)
                                       throws BufferUnderflowException,
                                              IllegalStateException

Copy a sub sequence of bytes as a BytesStore.

Parameters:

start - of bytes

length - of bytes

Returns:

ByteStore copy.

Throws:

IllegalStateException - if released

BufferUnderflowException

findByte

default long findByte(byte stopByte)
               throws IllegalStateException

Throws:

IllegalStateException

readUtf8

default <T extends Appendable & CharSequence> long readUtf8(long offset,
                                                            @NotNull
                                                            T sb)
                                                     throws net.openhft.chronicle.core.io.IORuntimeException,
                                                            IllegalArgumentException,
                                                            BufferUnderflowException,
                                                            ArithmeticException,
                                                            IllegalStateException

Truncates sb (it must be a StringBuilder or Bytes) and reads a char sequence from the given offset, encoded as Utf8, into it. Returns offset after the read Utf8, if a normal char sequence was read, or -1 - offset, if null was observed (in this case, sb is truncated too, but not updated then, by querying sb only this case is indistinguishable from reading an empty char sequence).

Type Parameters:

T - buffer type, must be StringBuilder or Bytes

Parameters:

offset - the offset in this RandomDataInput to read char sequence from

sb - the buffer to read char sequence into (truncated first)

Returns:

offset after the normal read char sequence, or -1 - offset, if char sequence is null

Throws:

IllegalStateException - if released

net.openhft.chronicle.core.io.IORuntimeException

IllegalArgumentException

BufferUnderflowException

ArithmeticException

See Also:

RandomDataOutput.writeUtf8(long, CharSequence)

readUtf8Limited

default <T extends Appendable & CharSequence> long readUtf8Limited(long offset,
                                                                   @NotNull
                                                                   T sb,
                                                                   int maxUtf8Len)
                                                            throws net.openhft.chronicle.core.io.IORuntimeException,
                                                                   IllegalArgumentException,
                                                                   BufferUnderflowException,
                                                                   IllegalStateException

Truncates sb (it must be a StringBuilder or Bytes) and reads a char sequence from the given offset, encoded as Utf8, into it. Returns offset after the read Utf8, if a normal char sequence was read, or -1 - offset, if null was observed (in this case, sb is truncated too, but not updated then, by querying sb only this case is indistinguishable from reading an empty char sequence). If length of Utf8 encoding of the char sequence exceeds maxUtf8Len, IllegalStateException is thrown.

Type Parameters:

T - buffer type, must be StringBuilder or Bytes

Parameters:

offset - the offset in this RandomDataInput to read char sequence from

sb - the buffer to read char sequence into (truncated first)

maxUtf8Len - the maximum allowed length of the char sequence in Utf8 encoding

Returns:

offset after the normal read char sequence, or -1 - offset, if char sequence is null

Throws:

IllegalStateException - if released

net.openhft.chronicle.core.io.IORuntimeException

IllegalArgumentException

BufferUnderflowException

See Also:

RandomDataOutput.writeUtf8Limited(long, CharSequence, int)

readUtf8Limited

@Nullable
default @Nullable String readUtf8Limited(long offset,
                                                   int maxUtf8Len)
                                            throws BufferUnderflowException,
                                                   net.openhft.chronicle.core.io.IORuntimeException,
                                                   IllegalArgumentException,
                                                   IllegalStateException

Reads a char sequence from the given offset, encoded as Utf8. If length of Utf8 encoding of the char sequence exceeds maxUtf8Len, IllegalStateException is thrown.

Parameters:

offset - the offset in this RandomDataInput to read char sequence from

maxUtf8Len - the maximum allowed length of the char sequence in Utf8 encoding

Returns:

the char sequence was read

Throws:

IllegalStateException - if released

BufferUnderflowException

net.openhft.chronicle.core.io.IORuntimeException

IllegalArgumentException

See Also:

RandomDataOutput.writeUtf8Limited(long, CharSequence, int)

compareUtf8

default boolean compareUtf8(long offset,
                            @Nullable
                            @Nullable CharSequence other)
                     throws net.openhft.chronicle.core.io.IORuntimeException,
                            BufferUnderflowException,
                            IllegalStateException

Compares the UTF-8 encoded char sequence, written in this RandomDataInput at the given offset, with the given char sequence. Returns true, if they are equal. Both char sequences (encoded in bytes and the given) may be null.

Parameters:

offset - the offset in this RandomDataInput where the char sequence to compare is written

other - the second char sequence to compare

Returns:

true if two char sequences are equal

Throws:

IllegalStateException - if released

net.openhft.chronicle.core.io.IORuntimeException - if the contents are not a valid string.

BufferUnderflowException

toByteArray

default byte[] toByteArray()
                    throws IllegalStateException

Throws:

IllegalStateException

read

default long read(long offsetInRDI,
                  byte[] bytes,
                  int offset,
                  int length)
           throws IllegalStateException

Throws:

IllegalStateException

toTemporaryDirectByteBuffer

default ByteBuffer toTemporaryDirectByteBuffer()
                                        throws IllegalArgumentException,
                                               ArithmeticException,
                                               IllegalStateException

Throws:

IllegalArgumentException

ArithmeticException

IllegalStateException

fastHash

default int fastHash(long offset,
                     int length)
              throws BufferUnderflowException,
                     IllegalStateException

Throws:

BufferUnderflowException

IllegalStateException

canReadDirect

default boolean canReadDirect()

canReadDirect

default boolean canReadDirect(long length)

start

default long start()

Returns:

The smallest position allowed in this buffer.

capacity

default long capacity()

Returns:

the highest limit allowed for this buffer.

readPosition

default long readPosition()

Returns the read position.

The read position is start() <= readPosition() && readPosition() <= readLimit() && readPosition < safeLimit()

If the resource is closed, the returned value is unspecified.

Returns:

position to read from.

writePosition

default long writePosition()

Returns the write position. The write position is readPosition() <= writePosition() && writePosition() <= writeLimit()

If the resource is closed, the returned value is unspecified.

Returns:

position to write to.

lengthWritten

default long lengthWritten(long startPosition)

Typically this calculates the difference however for HexDumpBytes it's not as simple.

If the resource is closed, the returned value is unspecified.

Parameters:

startPosition - to compare against

Returns:

the length from the startPosition

readRemaining

default long readRemaining()

Returns the remaining bytes that can be read.

If the resource is closed, the returned value is unspecified.

Returns:

How many more bytes can we read.

realReadRemaining

default long realReadRemaining()

If the resource is closed, the returned value is unspecified.

Returns:

how much can be safely read directly.

writeRemaining

default long writeRemaining()

If the resource is closed, the returned value is unspecified.

Returns:

How many more bytes can we written.

realWriteRemaining

default long realWriteRemaining()

If the resource is closed, the returned value is unspecified.

Returns:

writeRemaining with resize

readLimit

default long readLimit()

If the resource is closed, the returned value is unspecified.

Returns:

the highest offset or position allowed for this buffer.

writeLimit

default long writeLimit()

Returns the write limit.

If the resource is closed, the returned value is unspecified.

Returns:

the write limit

addressForRead

long addressForRead(long offset)
             throws UnsupportedOperationException,
                    BufferUnderflowException,
                    IllegalStateException

Obtain the underlying addressForRead. This is for expert users only.

Parameters:

offset - within this buffer. addressForRead(start()) is the actual addressForRead of the first byte.

Returns:

the underlying addressForRead of the buffer

Throws:

UnsupportedOperationException - if the underlying buffer is on the heap

BufferUnderflowException - if the offset is before the start() or the after the capacity()

IllegalStateException

addressForRead

default long addressForRead(long offset,
                            int buffer)
                     throws UnsupportedOperationException,
                            BufferUnderflowException,
                            IllegalStateException

Throws:

UnsupportedOperationException

BufferUnderflowException

IllegalStateException

addressForWrite

long addressForWrite(long offset)
              throws UnsupportedOperationException,
                     BufferOverflowException,
                     IllegalStateException

Obtain the underlying addressForRead. This is for expert users only.

Parameters:

offset - within this buffer. addressForRead(start()) is the actual addressForRead of the first byte.

Returns:

the underlying addressForRead of the buffer

Throws:

UnsupportedOperationException - if the underlying buffer is on the heap

BufferOverflowException - if the offset is before the start() or the after the capacity()

IllegalStateException

addressForWritePosition

long addressForWritePosition()
                      throws UnsupportedOperationException,
                             BufferOverflowException,
                             IllegalStateException

Throws:

UnsupportedOperationException

BufferOverflowException

IllegalStateException

byteOrder

default ByteOrder byteOrder()

bytesForRead

@NotNull
@NotNull Bytes<?> bytesForRead()
                                 throws IllegalStateException

Returns:

the streaming bytes for reading.

Throws:

IllegalStateException

bytesForWrite

@NotNull
@NotNull Bytes<?> bytesForWrite()
                                  throws IllegalStateException

Returns:

the streaming bytes for writing.

Throws:

IllegalStateException

sharedMemory

boolean sharedMemory()

Returns:

true if these Bytes use shared memory.

isDirectMemory

boolean isDirectMemory()