net.openhft.chronicle.bytes.internal

Interface UncheckedRandomDataInput

public interface UncheckedRandomDataInput

This interface defines methods for reading data of different types (byte, short, int, long) from a certain offset position. The methods do not necessarily perform boundary checks, so it's crucial to ensure memory bounds are validated before invoking these methods.

Note: Calling these methods without proper boundary checks can lead to undefined results and even JVM crashes.

Method Summary

Modifier and Type	Method and Description
byte	readByte(long offset) Read a byte at an offset possibly not checking memory bounds.
int	readInt(long offset) Read an int at an offset possibly not checking memory bounds.
long	readLong(long offset) Read a long at an offset possibly not checking memory bounds.
short	readShort(long offset) Read a short at an offset possibly not checking memory bounds.

Method Detail

readByte

byte readByte(long offset)
       throws net.openhft.chronicle.core.io.ClosedIllegalStateException

Read a byte at an offset possibly not checking memory bounds.

Memory bounds must be checked before invoking this method or else the result is undefined and may lead to JVM crashes.

Parameters:

offset - Offset position from which the byte is to be read.

Returns:

The byte read from the specified offset.

Throws:

BufferUnderflowException - If the offset is beyond the boundary of the data source.

net.openhft.chronicle.core.io.ClosedIllegalStateException - If the resource has been released or closed.

net.openhft.chronicle.core.io.ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

readShort

short readShort(long offset)
         throws net.openhft.chronicle.core.io.ClosedIllegalStateException

Read a short at an offset possibly not checking memory bounds.

Memory bounds must be checked before invoking this method or else the result is undefined and may lead to JVM crashes.

Parameters:

offset - Offset position from which the short is to be read.

Returns:

The short read from the specified offset.

Throws:

BufferUnderflowException - If the offset is beyond the boundary of the data source.

net.openhft.chronicle.core.io.ClosedIllegalStateException - If the resource has been released or closed.

net.openhft.chronicle.core.io.ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

readInt

int readInt(long offset)
     throws net.openhft.chronicle.core.io.ClosedIllegalStateException

Read an int at an offset possibly not checking memory bounds.

Memory bounds must be checked before invoking this method or else the result is undefined and may lead to JVM crashes.

Parameters:

offset - Offset position from which the integer is to be read.

Returns:

The integer read from the specified offset.

Throws:

BufferUnderflowException - If the offset is beyond the boundary of the data source.

net.openhft.chronicle.core.io.ClosedIllegalStateException - If the resource has been released or closed.

net.openhft.chronicle.core.io.ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

readLong

long readLong(long offset)
       throws net.openhft.chronicle.core.io.ClosedIllegalStateException

Read a long at an offset possibly not checking memory bounds.

Memory bounds must be checked before invoking this method or else the result is undefined and may lead to JVM crashes.

Parameters:

offset - Offset position from which the long is to be read.

Returns:

The long read from the specified offset.

Throws:

BufferUnderflowException - If the offset is beyond the boundary of the data source.

net.openhft.chronicle.core.io.ClosedIllegalStateException - If the resource has been released or closed.

net.openhft.chronicle.core.io.ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way