UncheckedNativeBytes (OpenHFT/Chronicle Bytes 2.24ea20 API)

java.lang.Object
- net.openhft.chronicle.core.io.AbstractReferenceCounted
- - net.openhft.chronicle.bytes.UncheckedNativeBytes

Type Parameters:

U - The type of the object this Bytes can point to.

All Implemented Interfaces:

Appendable, CharSequence, Bytes, BytesIn, BytesOut, BytesPrepender<Bytes>, BytesStore<Bytes,U>, ByteStringAppender<Bytes>, ByteStringParser<Bytes>, HexDumpBytesDescription<BytesOut>, HasUncheckedRandomDataInput, RandomDataInput, RandomDataOutput<Bytes>, DecimalAppender, StreamingCommon<Bytes>, StreamingDataInput<Bytes>, StreamingDataOutput<Bytes>, net.openhft.chronicle.core.io.ReferenceCounted, net.openhft.chronicle.core.io.ReferenceCountedTracer, net.openhft.chronicle.core.io.ReferenceOwner, net.openhft.chronicle.core.io.SingleThreadedChecked
```
public class UncheckedNativeBytes
extends net.openhft.chronicle.core.io.AbstractReferenceCounted
implements Bytes, HasUncheckedRandomDataInput, DecimalAppender
```
An optimized extension of AbstractBytes that performs unchecked read and write operations on a Bytes instance that is backed by native memory. The class bypasses bounds checking to provide high-performance access to the underlying data.
This class is intended for use in performance-critical scenarios where the client can ensure that all operations stay within valid bounds, thus avoiding the overhead of bounds checking.
Warning: Using this class improperly can result in IndexOutOfBoundsException being thrown, corruption of data, JVM crashes, or other undefined behavior.

Field Summary

Fields
Modifier and Type	Field and Description
`protected @NotNull BytesStore<?,U>`	`bytesStore`
`protected long`	`capacity`
`protected long`	`readPosition`
`protected long`	`writeLimit`
`protected long`	`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_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

Fields inherited from interface net.openhft.chronicle.core.io.SingleThreadedChecked
DISABLE_SINGLE_THREADED_CHECK

Constructor Summary

Constructors
Constructor and Description

UncheckedNativeBytes(@NotNull Bytes underlyingBytes)
Constructs an UncheckedNativeBytes instance by wrapping around the provided Bytes object.

Constructors
Constructor and Description
`UncheckedNativeBytes(@NotNull Bytes<U> underlyingBytes)` Constructs an UncheckedNativeBytes instance by wrapping around the provided Bytes object.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`@NotNull UncheckedRandomDataInput`	`acquireUncheckedInput()` Returns a view of a memory segment providing memory read operations with potentially unchecked memory boundaries.
`long`	`addressForRead(long offset)` Retrieves the underlying memory address for reading.
`long`	`addressForWrite(long offset)` Retrieves the underlying memory address for writing.
`long`	`addressForWritePosition()` Retrieves the underlying memory address for writing at the current write position.
`void`	`append(boolean negative, long mantissa, int exponent)` Appends a decimal number, represented by its sign, mantissa, and exponent, to a target.
`@NotNull UncheckedNativeBytes<U>`	`append(double d)` Appends a double in decimal notation
`@NotNull UncheckedNativeBytes<U>`	`append(float f)` Appends a float in decimal notation
`@NotNull Bytes<U>`	`append(int value)` Appends an int in decimal to this.
`@NotNull Bytes<U>`	`append(long value)` Appends a long value in decimal.
`@NotNull Bytes<U>`	`append8bit(@NotNull CharSequence cs)` Appends a String to the Bytes in ISO-8859-1.
`long`	`appendAndReturnLength(long writePosition, boolean negative, long mantissa, int exponent, boolean append0)`
`@NotNull Bytes<U>`	`appendUtf8(char[] chars, int offset, int length)` Appends a UTF-8 encoded CharSequence to this output stream from a specific offset and length.
`int`	`byteCheckSum()` Returns the bytes sum of the readable bytes in this BytesStore.
`@Nullable BytesStore`	`bytesStore()` Returns the backing BytesStore that this Bytes object wraps.
`long`	`capacity()` Provides the maximum limit that can be set for the ByteStore.
`@NotNull Bytes<U>`	`clear()` Clears the content of this Bytes object and resets its state.
`@NotNull Bytes<U>`	`clearAndPad(long length)` Clears the buffer and pads it with a specified length to allow prepending later.
`@NotNull Bytes<U>`	`compact()` Compacts this Bytes object by moving the readPosition() to the start(), adjusting the readLimit()/writePosition() appropriately so that the readRemaining() is unchanged.
`boolean`	`compareAndSwapInt(long offset, int expected, int value)` Perform a 32-bit CAS at a given offset.
`boolean`	`compareAndSwapLong(long offset, long expected, long value)` Perform a 64-bit CAS at a given offset.
`@NotNull BytesStore<Bytes<U>,U>`	`copy()` Creates and returns a deep copy of this Bytes object, including the data between `RandomCommon.readPosition()` and `RandomCommon.readLimit()`.
`Decimaliser`	`decimaliser()` Gets the Decimaliser currently associated with this ByteStringAppender.
`Bytes<U>`	`decimaliser(Decimaliser decimaliser)` Associates a Decimaliser with this ByteStringAppender.
`void`	`ensureCapacity(long desiredCapacity)` Ensures that this Bytes object has the capacity to accommodate the specified amount of data.
`boolean`	`equals(Object obj)`
`boolean`	`fpAppend0()`
`Bytes<U>`	`fpAppend0(boolean append0)`
`int`	`hashCode()`
`byte[]`	`internalNumberBuffer()` Deprecated.
`boolean`	`isDirectMemory()` Checks if this BytesStore uses direct memory.
`boolean`	`isElastic()` Checks if this Bytes object is elastic, meaning it can dynamically resize when more data is written than its current `Bytes.realCapacity()`.
`int`	`lastDecimalPlaces()` Returns the number of decimal places in the last parsed floating-point number (from the `ByteStringParser.parseDouble()` or `ByteStringParser.parseLongDecimal()` methods).
`void`	`lastDecimalPlaces(int lastDecimalPlaces)` Sets the number of decimal places in the last parsed number.
`boolean`	`lastNumberHadDigits()` Returns whether the last parsed number had any digits.
`void`	`lastNumberHadDigits(boolean lastNumberHadDigits)` Sets whether the last parsed number had any digits.
`boolean`	`lenient()`
`void`	`lenient(boolean lenient)` When there is no more data to read, return zero, `false` and empty string.
`void`	`move(long from, long to, long length)` Moves a sequence of bytes within this BytesStore from the source to destination index.
`void`	`nativeRead(long position, long address, long size)` Expert-level method for transferring data from this byte source to native memory.
`void`	`nativeWrite(long address, long position, long size)` Expert-level method that copies data directly from native memory into this BytesStore.
`int`	`peekUnsignedByte()` Peeks (reads without moving the read pointer) the next unsigned byte from the input stream.
`int`	`peekUnsignedByte(long offset)` Reads an unsigned byte value from a specific offset.
`protected void`	`performRelease()`
`@NotNull Bytes<U>`	`prewrite(@NotNull byte[] bytes)` Writes a byte array backward in binary format.
`@NotNull Bytes<U>`	`prewrite(@NotNull BytesStore bytes)` Writes a BytesStore instance backward in binary format.
`@NotNull Bytes<U>`	`prewriteByte(byte i8)` Writes a byte backward in binary format.
`@NotNull Bytes<U>`	`prewriteInt(int i)` Writes an int (4-byte int) backward in binary format.
`@NotNull Bytes<U>`	`prewriteLong(long i64)` Writes a long (8-byte int) backward in binary format.
`protected long`	`prewriteOffsetPositionMoved(long substracting)`
`@NotNull Bytes<U>`	`prewriteShort(short i16)` Writes a short (2-byte int) backward in binary format.
`long`	`rawCopy(@NotNull RandomDataInput bytes, long offset, long length)`
`Bytes<U>`	`rawWriteByte(byte i8)` Writes a byte to the data stream without any additional checks or transformations.
`byte`	`readByte()` Reads a byte value from the input stream.
`byte`	`readByte(long offset)` Reads a byte value from a specific offset.
`double`	`readDouble()` Reads a 64-bit floating-point number from the input stream.
`double`	`readDouble(long offset)` Reads a 64-bit floating point value from a specified offset.
`float`	`readFloat()` Reads a 32-bit floating-point number from the input stream.
`float`	`readFloat(long offset)` Reads a 32-bit floating point value from a specified offset.
`int`	`readInt()` Reads a 32-bit integer value from the input stream.
`int`	`readInt(long offset)` Reads a 32-bit integer value from a specific offset.
`long`	`readLimit()` If the resource is closed, the returned value is unspecified.
`@NotNull Bytes<U>`	`readLimit(long limit)` Sets the read limit of this StreamingDataInput.
`long`	`readLong()` Reads a 64-bit long value from the input stream.
`long`	`readLong(long offset)` Reads a 64-bit long value from a specific offset.
`protected long`	`readOffsetPositionMoved(long adding)`
`long`	`readPosition()` Returns the read position.
`@NotNull Bytes<U>`	`readPosition(long position)` Sets the read position of this StreamingDataInput.
`short`	`readShort()` Reads a 16-bit short value from the input stream.
`short`	`readShort(long offset)` Reads a short value from a specific offset.
`@NotNull Bytes<U>`	`readSkip(long bytesToSkip)` Skips the specified number of bytes by advancing the read position.
`int`	`readUnsignedByte()` Reads the next unsigned 8-bit value from the input stream.
`int`	`readUnsignedByte(long offset)` Reads an unsigned byte value from a specific offset.
`byte`	`readVolatileByte(long offset)` Reads a volatile 8-bit byte value from a specified offset.
`int`	`readVolatileInt()` Reads a volatile (concurrently mutable) integer value from the input stream.
`int`	`readVolatileInt(long offset)` Reads a volatile 32-bit integer value from a specified offset.
`long`	`readVolatileLong()` Reads a volatile (concurrently mutable) long value from the input stream.
`long`	`readVolatileLong(long offset)` Reads a volatile 64-bit long value from a specified offset.
`short`	`readVolatileShort(long offset)` Reads a volatile 16-bit short value from a specified offset.
`long`	`realCapacity()` Returns the actual capacity of the ByteStore before any resizing occurs.
`long`	`realWriteRemaining()` Calculates the number of bytes remaining that can be written from the current write position with resizing.
`void`	`testAndSetInt(long offset, int expected, int value)` Tests if the current value at the specified offset equals the expected value and, if so, sets it to the provided value.
`@NotNull String`	`toString()`
`boolean`	`unchecked()` Checks whether this Bytes object operates in an unchecked mode.
`@NotNull Bytes<U>`	`unchecked(boolean unchecked)` Creates and returns a new Bytes which is optionally unchecked as indicated by the provided `unchecked`.
`void`	`uncheckedReadSkipBackOne()` Unchecked version of readSkip(-1).
`void`	`uncheckedReadSkipOne()` Unchecked version of readSkip(1).
`int`	`uncheckedReadUnsignedByte()` Reads the next unsigned 8-bit value from the input stream without performing boundary checks.
`U`	`underlyingObject()`
`@NotNull Bytes<U>`	`write(byte[] byteArray, int offset, int length)` Writes the specified number of bytes from the given `byteArray` into the output stream, starting from the given offset.
`@NotNull Bytes<U>`	`write(long offsetInRDO, byte[] byteArray, int offset, int length)` Copies the provided `byteArray` to this Bytes object starting at `writeOffset` taking content starting at `readOffset` but copying at most `length` bytes.
`void`	`write(long offsetInRDO, @NotNull ByteBuffer bytes, int offset, int length)` Copies a segment from the provided ByteBuffer into this data output.
`@NotNull Bytes<U>`	`write(long writeOffset, @NotNull RandomDataInput bytes, long readOffset, long length)` Copies a segment from the provided RandomDataInput into this data output.
`@NotNull Bytes<U>`	`write(@NotNull RandomDataInput bytes)` Writes all available data from the specified `RandomDataInput` into the output stream.
`@NotNull Bytes<U>`	`write(@NotNull RandomDataInput bytes, long offset, long length)` Writes the specified number of bytes from the provided `RandomDataInput` object into the output stream, starting from the given read offset.
`Bytes<U>`	`write8bit(@Nullable BytesStore bs)`
`long`	`write8bit(long position, @NotNull BytesStore bs)` Writes a BytesStore instance to this RandomDataOutput at the given position.
`long`	`write8bit(long position, @NotNull String s, int start, int length)` Writes a portion of a string to this RandomDataOutput at the given position.
`@NotNull Bytes<U>`	`write8bit(@NotNull String text, int start, int length)` Writes a subsequence of a String as an 8-bit string to the data stream.
`@NotNull Bytes<U>`	`writeByte(byte i8)` Writes a byte to the data stream.
`@NotNull Bytes<U>`	`writeByte(long offset, byte i)` Writes a byte at the specified non-negative offset.
`@NotNull Bytes<U>`	`writeDouble(double d)` Writes a double-precision floating-point number to the data stream.
`@NotNull Bytes<U>`	`writeDouble(long offset, double d)` Writes a double-precision floating-point value at the specified non-negative offset.
`@NotNull Bytes<U>`	`writeDoubleAndInt(double d, int i)` Writes a double-precision floating-point number followed by an integer to the data stream.
`@NotNull Bytes<U>`	`writeFloat(float f)` Writes a floating-point number to the data stream.
`@NotNull Bytes<U>`	`writeFloat(long offset, float d)` Writes a single-precision floating-point value at the specified non-negative offset.
`@NotNull Bytes<U>`	`writeInt(int i)` Writes an integer to the data stream.
`@NotNull Bytes<U>`	`writeInt(long offset, int i)` Writes an integer value at the specified non-negative offset.
`@NotNull Bytes<U>`	`writeIntAdv(int i, int advance)` Writes an integer to the data stream, then advances the write position by the specified amount.
`long`	`writeLimit()` Retrieves the maximum writable position within the buffer.
`@NotNull Bytes<U>`	`writeLimit(long limit)` Sets the limit for writing to the data stream.
`@NotNull Bytes<U>`	`writeLong(long i64)` Writes a long integer to the data stream.
`@NotNull Bytes<U>`	`writeLong(long offset, long i)` Writes a long integer value at the specified non-negative offset.
`@NotNull Bytes<U>`	`writeLongAdv(long i64, int advance)` Writes a long integer to the data stream, then advances the write position by the specified amount.
`protected long`	`writeOffsetPositionMoved(long adding)`
`protected long`	`writeOffsetPositionMoved(long adding, long advance)`
`@NotNull Bytes<U>`	`writeOrderedInt(int i)` Writes an integer value to this output stream using an ordered-writing mechanism.
`@NotNull Bytes<U>`	`writeOrderedInt(long offset, int i)` Performs a non-blocking write operation with a memory barrier to ensure order of stores.
`@NotNull Bytes<U>`	`writeOrderedLong(long i)` Writes a long value to this output stream using an ordered-writing mechanism.
`@NotNull Bytes<U>`	`writeOrderedLong(long offset, long i)` Performs a non-blocking write operation with a memory barrier to ensure order of stores.
`long`	`writePosition()` Returns the write position.
`@NotNull Bytes<U>`	`writePosition(long position)` Sets the current write position in the data stream.
`@NotNull Bytes<U>`	`writeShort(long offset, short i)` Writes a short integer at the specified non-negative offset.
`@NotNull Bytes<U>`	`writeShort(short i16)` Writes a short integer to the data stream.
`@NotNull Bytes<U>`	`writeSkip(long bytesToSkip)` Skips a specified number of bytes from the current write position in the data stream.
`@NotNull Bytes<U>`	`writeSome(@NotNull ByteBuffer buffer)` Writes the available data from the provided `ByteBuffer` into this Bytes object.
`@NotNull Bytes<U>`	`writeVolatileByte(long offset, byte i8)` Writes a volatile byte at the specified non-negative offset.
`@NotNull Bytes<U>`	`writeVolatileInt(long offset, int i32)` Writes a volatile integer at the specified non-negative offset.
`@NotNull Bytes<U>`	`writeVolatileLong(long offset, long i64)` Writes a volatile long integer at the specified non-negative offset.
`@NotNull Bytes<U>`	`writeVolatileShort(long offset, short i16)` Writes a volatile short at the specified non-negative offset.

Methods inherited from class net.openhft.chronicle.core.io.AbstractReferenceCounted
addReferenceChangeListener, assertReferencesReleased, backgroundPerformRelease, canReleaseInBackground, clearUsedByThread, createdHere, disableReferenceTracing, enableReferenceTracing, refCount, referenceCountedUnmonitored, referenceId, release, releaseLast, removeReferenceChangeListener, reserve, reservedBy, reserveTransfer, singleThreadedCheckDisabled, singleThreadedCheckReset, 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.Bytes
allocateDirect, allocateDirect, allocateElasticDirect, allocateElasticDirect, allocateElasticOnHeap, allocateElasticOnHeap, bytesForRead, bytesForWrite, copyTo, copyTo, directFrom, elasticByteBuffer, elasticByteBuffer, elasticByteBuffer, elasticHeapByteBuffer, elasticHeapByteBuffer, empty, forFieldGroup, from, from, fromDirect, fromHexString, indexOf, indexOf, isClear, isEqual, readMarshallableLength16, readWithLength, readWrite, safeLimit, sharedMemory, toHexString, toHexString, toHexString, toString, toString, toString, unwrite, valueOf, wrapForRead, wrapForRead, wrapForWrite, wrapForWrite, write, writeMarshallableLength16

Methods inherited from interface net.openhft.chronicle.bytes.BytesStore
addAndGetDouble, addAndGetDoubleNotAtomic, addAndGetFloat, addAndGetFloatNotAtomic, addAndGetInt, addAndGetIntNotAtomic, addAndGetLong, addAndGetShortNotAtomic, addAndGetUnsignedByteNotAtomic, byteCheckSum, charAt, cipher, cipher, compareAndSwapDouble, compareAndSwapFloat, contentEquals, elasticByteBuffer, endsWith, equalBytes, follow, forFields, from, hash, inside, inside, isEmpty, isEqual, isImmutableEmptyByteStore, lazyNativeBytesStoreWithFixedCapacity, length, nativePointer, nativeStore, nativeStoreFrom, nativeStoreWithFixedCapacity, 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
canReadDirect, canReadDirect, compareUtf8, copyTo, copyTo, createCharToString, fastHash, findByte, parseLong, peekVolatileInt, printable, read, readBoolean, readIncompleteLong, readUnsignedInt, readUnsignedInt24, readUnsignedShort, readUtf8, readUtf8Limited, readUtf8Limited, readVolatileDouble, readVolatileFloat, subBytes, toByteArray, toTemporaryDirectByteBuffer

Methods inherited from interface net.openhft.chronicle.bytes.ByteStringParser
parse8bit, parse8bit, parse8bit, parse8bit, parse8bit, parseBigDecimal, parseBoolean, parseBoolean, parseDouble, parseFlexibleLong, parseFloat, parseInt, parseLong, parseLongDecimal, parseUtf8, parseUtf8, parseUtf8, reader, skipTo

Methods inherited from interface net.openhft.chronicle.bytes.StreamingDataInput
inputStream, parseHexLong, parseUtf8, parseUtf8, rawReadByte, rawReadInt, rawReadLong, read, read, read, read, read, read, read8bit, read8bit, read8bit, readBigDecimal, readBigInteger, readBoolean, readChar, readEnum, readHistogram, readIncompleteLong, readInt24, readLimitToCapacity, readPositionForHeader, readPositionRemaining, readPositionUnlimited, readStopBit, readStopBitChar, readStopBitDecimal, readStopBitDouble, readUnsignedInt, readUnsignedInt24, readUnsignedShort, readUtf8, readUtf8, readUtf8, readUtf8, readWithLength, readWithLength, readWithLength0, unsafeRead, 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, append8bit, append8bit, append8bit, append8bit, appendBase, appendBase16, appendBase16, appendDateMillis, appendDecimal, appendTimeMillis, writer

Methods inherited from interface net.openhft.chronicle.bytes.StreamingDataOutput
appendUtf8, appendUtf8, appendUtf8, appendUtf8, appendUtf8, canWriteDirect, copyFrom, outputStream, rawWriteInt, rawWriteLong, unsafeWrite, unsafeWriteObject, unsafeWriteObject, write, write, write, write, write, write8bit, write8bit, write8bit, writeBigDecimal, writeBigInteger, writeBoolean, writeChar, writeEnum, writeHistogram, writeInt24, writePositionForHeader, writePositionRemaining, writeSome, writeStopBit, writeStopBit, writeStopBit, writeStopBitDecimal, writeUnsignedByte, writeUnsignedInt, writeUnsignedInt24, writeUnsignedShort, writeUtf8, writeUtf8, writeWithLength

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

Methods inherited from interface net.openhft.chronicle.bytes.HexDumpBytesDescription
adjustHexDumpIndentation, retainedHexDumpDescription, writeHexDumpDescription

Methods inherited from interface net.openhft.chronicle.core.io.SingleThreadedChecked
singleThreadedCheckDisabled, singleThreadedCheckReset

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

- Field Detail
 - capacity
```
protected final long capacity
```
 - bytesStore
```
@NotNull
protected @NotNull BytesStore<?,U> bytesStore
```
 - readPosition
```
protected long readPosition
```
 - writePosition
```
protected long writePosition
```
 - writeLimit
```
protected long writeLimit
```
- Constructor Detail
 - UncheckedNativeBytes
```
public UncheckedNativeBytes(@NotNull
 @NotNull Bytes underlyingBytes)
 throws IllegalStateException
```
 Constructs an UncheckedNativeBytes instance by wrapping around the provided Bytes object.
 
 Parameters:
 
 underlyingBytes - the Bytes object to wrap around
 
 Throws:
 
 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
 
 IllegalStateException
- Method Detail
 - ensureCapacity
```
public void ensureCapacity(long desiredCapacity)
 throws IllegalArgumentException,
 IllegalStateException
```
 Description copied from interface: Bytes
 
 Ensures that this Bytes object has the capacity to accommodate the specified amount of data.
 If this Bytes object is elastic and doesn't have enough capacity, it will be resized. If it is not elastic and doesn't have enough capacity, a DecoratedBufferOverflowException will be thrown.
 
 Specified by:
 
 ensureCapacity in interface Bytes
 
 Specified by:
 
 ensureCapacity in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 desiredCapacity - The minimum capacity, in bytes, that is required.
 
 Throws:
 
 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
 
 IllegalArgumentException
 
 IllegalStateException
 - unchecked
```
public boolean unchecked()
```
 Description copied from interface: Bytes
 
 Checks whether this Bytes object operates in an unchecked mode.
 When a Bytes object is unchecked, it performs minimal or no bounds checking on read and write operations. This can improve performance but may result in undefined behavior if attempting to access out-of-bounds elements.
 
 Specified by:
 
 unchecked in interface Bytes
 
 Returns:
 
 true if this Bytes object operates in unchecked mode; false otherwise.
 - isDirectMemory
```
public boolean isDirectMemory()
```
 Description copied from interface: BytesStore
 
 Checks if this BytesStore uses direct memory.
 
 Specified by:
 
 isDirectMemory in interface BytesStore<Bytes,U>
 
 Returns:
 
 true if it uses direct memory, false otherwise
 - unchecked
```
@NotNull
public @NotNull Bytes unchecked(boolean unchecked)
```
 Description copied from interface: Bytes
 
 Creates and returns a new Bytes which is optionally unchecked as indicated by the provided unchecked.
 This allows bounds checks to be turned off. Note: this means that the result is no longer elastic, even if this is elastic. Note: It is only possible to go from a checked Bytes to an unchecked bytes and not vice versa.
 
 Specified by:
 
 unchecked in interface Bytes
 
 Parameters:
 
 unchecked - if true, minimal bounds checks will be performed
 
 Returns:
 
 a new, potentially unchecked, Bytes
 - move
```
public void move(long from,
 long to,
 long length)
 throws IllegalStateException,
 BufferUnderflowException
```
 Description copied from interface: BytesStore
 
 Moves a sequence of bytes within this BytesStore from the source to destination index.
 
 Specified by:
 
 move in interface BytesStore<Bytes,U>
 
 Parameters:
 
 from - the index of the first byte to be moved
 
 to - the index where the first byte should be moved to
 
 length - the number of bytes to be moved
 
 Throws:
 
 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.
 
 BufferUnderflowException - If there's not enough data to be moved
 
 IllegalStateException
 - compact
```
@NotNull
public @NotNull Bytes compact()
 throws net.openhft.chronicle.core.io.ClosedIllegalStateException,
 net.openhft.chronicle.core.io.ThreadingIllegalStateException
```
 Description copied from interface: Bytes
 
 Compacts this Bytes object by moving the readPosition() to the start(), adjusting the readLimit()/writePosition() appropriately so that the readRemaining() is unchanged.
 This operation is useful to free up space for writing by discarding bytes that have already been read.
 NOTE: If the space freed in longs is less than 1/4 the readRemaining in longs, this method does nothing to reduce movement overhead
 
 Specified by:
 
 compact in interface Bytes
 
 Returns:
 
 This Bytes object, for method chaining.
 
 Throws:
 
 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
 - readPosition
```
@NotNull
public @NotNull Bytes readPosition(long position)
```
 Description copied from interface: StreamingDataInput
 
 Sets the read position of this StreamingDataInput.
 
 Specified by:
 
 readPosition in interface StreamingDataInput<Bytes>
 
 Parameters:
 
 position - the new read position, must be non-negative
 
 Returns:
 
 this StreamingDataInput instance, for chaining
 - readLimit
```
@NotNull
public @NotNull Bytes readLimit(long limit)
```
 Description copied from interface: StreamingDataInput
 
 Sets the read limit of this StreamingDataInput.
 
 Specified by:
 
 readLimit in interface StreamingDataInput<Bytes>
 
 Parameters:
 
 limit - the new read limit, must be non-negative
 
 Returns:
 
 this StreamingDataInput instance, for chaining
 - writePosition
```
@NotNull
public @NotNull Bytes writePosition(long position)
```
 Description copied from interface: StreamingDataOutput
 
 Sets the current write position in the data stream. The write position indicates the point where the next write operation will begin. Calling this method does not modify the data in the stream; it only changes the position where future write operations will take place.
 
 Specified by:
 
 writePosition in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 position - The new write position. It must be a non-negative number.
 
 Returns:
 
 The current StreamingDataOutput instance.
 - readSkip
```
@NotNull
public @NotNull Bytes readSkip(long bytesToSkip)
```
 Description copied from interface: StreamingDataInput
 
 Skips the specified number of bytes by advancing the read position. The number of bytes to skip must be less than or equal to the read limit.
 
 Specified by:
 
 readSkip in interface StreamingDataInput<Bytes>
 
 Parameters:
 
 bytesToSkip - the number of bytes to skip
 
 Returns:
 
 this StreamingDataInput instance, for chaining
 - readVolatileByte
```
public byte readVolatileByte(long offset)
 throws BufferUnderflowException
```
 Description copied from interface: RandomDataInput
 
 Reads a volatile 8-bit byte value from a specified offset. This operation includes a memory barrier that prevents reordering of instructions before and after it.
 
 Specified by:
 
 readVolatileByte in interface RandomDataInput
 
 Parameters:
 
 offset - the location from where the byte value is read.
 
 Returns:
 
 the volatile byte value.
 
 Throws:
 
 BufferUnderflowException - If the offset is beyond the limits of the byte source.
 - readVolatileShort
```
public short readVolatileShort(long offset)
 throws BufferUnderflowException
```
 Description copied from interface: RandomDataInput
 
 Reads a volatile 16-bit short value from a specified offset. This operation includes a memory barrier that prevents reordering of instructions before and after it.
 
 Specified by:
 
 readVolatileShort in interface RandomDataInput
 
 Parameters:
 
 offset - the location from where the short value is read.
 
 Returns:
 
 the volatile short value.
 
 Throws:
 
 BufferUnderflowException - If the offset is beyond the limits of the byte source.
 - readVolatileInt
```
public int readVolatileInt(long offset)
 throws BufferUnderflowException
```
 Description copied from interface: RandomDataInput
 
 Reads a volatile 32-bit integer value from a specified offset. This operation includes a memory barrier that prevents reordering of instructions before and after it.
 
 Specified by:
 
 readVolatileInt in interface RandomDataInput
 
 Parameters:
 
 offset - the location from where the int value is read.
 
 Returns:
 
 the volatile int value.
 
 Throws:
 
 BufferUnderflowException - If the offset is beyond the limits of the byte source.
 - readVolatileLong
```
public long readVolatileLong(long offset)
 throws BufferUnderflowException
```
 Description copied from interface: RandomDataInput
 
 Reads a volatile 64-bit long value from a specified offset. This operation includes a memory barrier that prevents reordering of instructions before and after it.
 
 Specified by:
 
 readVolatileLong in interface RandomDataInput
 
 Parameters:
 
 offset - the location from where the long value is read.
 
 Returns:
 
 the volatile long value.
 
 Throws:
 
 BufferUnderflowException - If the offset is beyond the limits of the byte source.
 - uncheckedReadSkipOne
```
public void uncheckedReadSkipOne()
```
 Description copied from interface: StreamingDataInput
 
 Unchecked version of readSkip(1). This method skips one byte without performing any limit checks. Use this method only when you are certain that it is safe to do so, and you have identified a performance issue with readSkip(1).
 
 Specified by:
 
 uncheckedReadSkipOne in interface StreamingDataInput<Bytes>
 - uncheckedReadSkipBackOne
```
public void uncheckedReadSkipBackOne()
```
 Description copied from interface: StreamingDataInput
 
 Unchecked version of readSkip(-1). This method skips back one byte without performing any limit checks. Use this method only when you are certain that it is safe to do so, and you have identified a performance issue with readSkip(-1).
 
 Specified by:
 
 uncheckedReadSkipBackOne in interface StreamingDataInput<Bytes>
 - writeSkip
```
@NotNull
public @NotNull Bytes writeSkip(long bytesToSkip)
```
 Description copied from interface: StreamingDataOutput
 
 Skips a specified number of bytes from the current write position in the data stream. This method adjusts the write position either forward or backward based on the value of bytesToSkip. The new position should not exceed the write limit.
 
 Specified by:
 
 writeSkip in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 bytesToSkip - The number of bytes to skip. This can be a negative number to move the position backward.
 
 Returns:
 
 The current StreamingDataOutput instance.
 - writeLimit
```
@NotNull
public @NotNull Bytes writeLimit(long limit)
```
 Description copied from interface: StreamingDataOutput
 
 Sets the limit for writing to the data stream. No data can be written beyond this limit. If an attempt is made to write data beyond this limit, a BufferOverflowException will be thrown.
 
 Specified by:
 
 writeLimit in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 limit - The new write limit. It must be a non-negative number.
 
 Returns:
 
 The current StreamingDataOutput instance.
 - copy
```
@NotNull
public @NotNull BytesStore<Bytes,U> copy()
```
 Description copied from interface: Bytes
 
 Creates and returns a deep copy of this Bytes object, including the data between RandomCommon.readPosition() and RandomCommon.readLimit().
 The copy will have its own separate storage and state, and modifications to the copy will not affect the original Bytes object, and vice versa.
 
 Specified by:
 
 copy in interface Bytes
 
 Specified by:
 
 copy in interface BytesStore<Bytes,U>
 
 Returns:
 
 A new Bytes object that is a copy of this object.
 - isElastic
```
public boolean isElastic()
```
 Description copied from interface: Bytes
 
 Checks if this Bytes object is elastic, meaning it can dynamically resize when more data is written than its current Bytes.realCapacity().
 Elastic Bytes objects can automatically grow to accommodate additional data, whereas non-elastic ones have a fixed capacity.
 
 Specified by:
 
 isElastic in interface Bytes
 
 Returns:
 
 true if this Bytes object is elastic; false otherwise.
 - readOffsetPositionMoved
```
protected long readOffsetPositionMoved(long adding)
```
 - writeOffsetPositionMoved
```
protected long writeOffsetPositionMoved(long adding)
```
 - writeOffsetPositionMoved
```
protected long writeOffsetPositionMoved(long adding,
 long advance)
```
 - prewriteOffsetPositionMoved
```
protected long prewriteOffsetPositionMoved(long substracting)
```
 - write
```
@NotNull
public @NotNull Bytes write(@NotNull
 @NotNull RandomDataInput bytes,
 long offset,
 long length)
 throws BufferUnderflowException,
 BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes the specified number of bytes from the provided RandomDataInput object into the output stream, starting from the given read offset. The position of this output stream is updated accordingly, but the read position of the input data is not changed.
 
 Specified by:
 
 write in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 bytes - the RandomDataInput from which data is read.
 
 offset - the offset at which reading from the RandomDataInput starts.
 
 length - the number of bytes to write.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 BufferUnderflowException - If there is not enough data available in the input.
 
 BufferOverflowException - If there is not enough space left in the output stream.
 
 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
 
 IllegalStateException
 - rawCopy
```
public long rawCopy(@NotNull
 @NotNull RandomDataInput bytes,
 long offset,
 long length)
 throws BufferOverflowException,
 BufferUnderflowException,
 IllegalStateException
```
 Throws:
 
 BufferOverflowException
 
 BufferUnderflowException
 
 IllegalStateException
 - clear
```
@NotNull
public @NotNull Bytes clear()
```
 Description copied from interface: Bytes
 
 Clears the content of this Bytes object and resets its state.
 
 Specified by:
 
 clear in interface Bytes
 
 Specified by:
 
 clear in interface StreamingCommon<Bytes>
 
 Returns:
 
 This Bytes object.
 - clearAndPad
```
@NotNull
public @NotNull Bytes clearAndPad(long length)
 throws BufferOverflowException
```
 Description copied from interface: BytesPrepender
 
 Clears the buffer and pads it with a specified length to allow prepending later. clearAndPad(0) is equivalent to clear().
 
 Specified by:
 
 clearAndPad in interface BytesPrepender<Bytes>
 
 Parameters:
 
 length - the padding length
 
 Returns:
 
 this instance, after clearing and padding
 
 Throws:
 
 BufferOverflowException - If the length is greater than the difference of capacity() and start()
 - readLimit
```
public long readLimit()
```
 If the resource is closed, the returned value is unspecified.
 
 Returns:
 
 the highest offset or position allowed for this buffer.
 - writeLimit
```
public long writeLimit()
```
 Retrieves the maximum writable position within the buffer.
 If the resource is closed, the returned value is unspecified.
 
 Returns:
 
 the write limit
 - realCapacity
```
public long realCapacity()
```
 Description copied from interface: BytesStore
 
 Returns the actual capacity of the ByteStore before any resizing occurs.
 
 Specified by:
 
 realCapacity in interface Bytes
 
 Specified by:
 
 realCapacity in interface BytesStore<Bytes,U>
 
 Specified by:
 
 realCapacity in interface RandomDataInput
 
 Specified by:
 
 realCapacity in interface StreamingDataOutput<Bytes>
 
 Returns:
 
 the current capacity of the ByteStore
 - realWriteRemaining
```
public long realWriteRemaining()
```
 Calculates the number of bytes remaining that can be written from the current write position with resizing.
 If the resource is closed, the returned value is unspecified.
 
 Returns:
 
 The number of bytes that can still be written with resizing.
 - capacity
```
public long capacity()
```
 Description copied from interface: BytesStore
 
 Provides the maximum limit that can be set for the ByteStore.
 
 Specified by:
 
 capacity in interface BytesStore<Bytes,U>
 
 Returns:
 
 the maximum capacity of the ByteStore
 - underlyingObject
```
@Nullable
public U underlyingObject()
```
 Specified by:
 
 underlyingObject in interface BytesStore<Bytes,U>
 
 Returns:
 
 the underlying object being wrapped, if there is one, or null if not.
 - readPosition
```
public 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
```
public 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.
 - compareAndSwapInt
```
public boolean compareAndSwapInt(long offset,
 int expected,
 int value)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataInput
 
 Perform a 32-bit CAS at a given offset.
 
 Specified by:
 
 compareAndSwapInt in interface BytesStore<Bytes,U>
 
 Specified by:
 
 compareAndSwapInt in interface RandomDataInput
 
 Specified by:
 
 compareAndSwapInt in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - to perform CAS
 
 expected - value
 
 value - to set
 
 Returns:
 
 true, if successful.
 
 Throws:
 
 BufferOverflowException - If the capacity of this RandomDataOutput was exceeded.
 
 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
 
 IllegalStateException
 - testAndSetInt
```
public void testAndSetInt(long offset,
 int expected,
 int value)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Tests if the current value at the specified offset equals the expected value and, if so, sets it to the provided value.
 
 Specified by:
 
 testAndSetInt in interface RandomDataInput
 
 Specified by:
 
 testAndSetInt in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - the offset at which to perform the test-and-set operation.
 
 expected - the expected current value.
 
 value - the new value to set if the current value matches the expected value.
 
 Throws:
 
 BufferOverflowException - If the capacity of this RandomDataOutput was exceeded.
 
 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
 
 IllegalStateException
 - compareAndSwapLong
```
public boolean compareAndSwapLong(long offset,
 long expected,
 long value)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataInput
 
 Perform a 64-bit CAS at a given offset.
 
 Specified by:
 
 compareAndSwapLong in interface BytesStore<Bytes,U>
 
 Specified by:
 
 compareAndSwapLong in interface RandomDataInput
 
 Specified by:
 
 compareAndSwapLong in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - to perform CAS
 
 expected - value
 
 value - to set
 
 Returns:
 
 true, if successful.
 
 Throws:
 
 BufferOverflowException - If the capacity of this RandomDataOutput was exceeded.
 
 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
 
 IllegalStateException
 - performRelease
```
protected void performRelease()
 throws IllegalStateException
```
 Specified by:
 
 performRelease in class net.openhft.chronicle.core.io.AbstractReferenceCounted
 
 Throws:
 
 IllegalStateException
 - readUnsignedByte
```
public int readUnsignedByte()
```
 Description copied from interface: StreamingDataInput
 
 Reads the next unsigned 8-bit value from the input stream. If there is no byte available, it returns -1.
 
 Specified by:
 
 readUnsignedByte in interface StreamingDataInput<Bytes>
 
 Returns:
 
 the next unsigned 8-bit value or -1
 - uncheckedReadUnsignedByte
```
public int uncheckedReadUnsignedByte()
```
 Description copied from interface: StreamingDataInput
 
 Reads the next unsigned 8-bit value from the input stream without performing boundary checks. If there is no byte available, it returns -1. Use this method with caution as it bypasses checks for data availability.
 
 Specified by:
 
 uncheckedReadUnsignedByte in interface StreamingDataInput<Bytes>
 
 Returns:
 
 the next unsigned 8-bit value or -1
 - readByte
```
public byte readByte()
```
 Description copied from interface: StreamingDataInput
 
 Reads a byte value from the input stream.
 
 Specified by:
 
 readByte in interface StreamingDataInput<Bytes>
 
 Returns:
 
 the byte value
 - peekUnsignedByte
```
public int peekUnsignedByte()
```
 Description copied from interface: StreamingDataInput
 
 Peeks (reads without moving the read pointer) the next unsigned byte from the input stream.
 
 Specified by:
 
 peekUnsignedByte in interface StreamingDataInput<Bytes>
 
 Returns:
 
 the peeked byte value
 - readShort
```
public short readShort()
```
 Description copied from interface: StreamingDataInput
 
 Reads a 16-bit short value from the input stream.
 
 Specified by:
 
 readShort in interface StreamingDataInput<Bytes>
 
 Returns:
 
 the 16-bit short value
 - readInt
```
public int readInt()
```
 Description copied from interface: StreamingDataInput
 
 Reads a 32-bit integer value from the input stream.
 
 Specified by:
 
 readInt in interface StreamingDataInput<Bytes>
 
 Returns:
 
 the 32-bit integer value
 - readLong
```
public long readLong()
```
 Description copied from interface: StreamingDataInput
 
 Reads a 64-bit long value from the input stream.
 
 Specified by:
 
 readLong in interface StreamingDataInput<Bytes>
 
 Returns:
 
 the 64-bit long value
 - readFloat
```
public float readFloat()
```
 Description copied from interface: StreamingDataInput
 
 Reads a 32-bit floating-point number from the input stream.
 
 Specified by:
 
 readFloat in interface StreamingDataInput<Bytes>
 
 Returns:
 
 the float value read from the stream
 - readDouble
```
public double readDouble()
```
 Description copied from interface: StreamingDataInput
 
 Reads a 64-bit floating-point number from the input stream.
 
 Specified by:
 
 readDouble in interface StreamingDataInput<Bytes>
 
 Returns:
 
 the double value read from the stream
 - readVolatileInt
```
public int readVolatileInt()
```
 Description copied from interface: StreamingDataInput
 
 Reads a volatile (concurrently mutable) integer value from the input stream.
 
 Specified by:
 
 readVolatileInt in interface StreamingDataInput<Bytes>
 
 Returns:
 
 the read integer value
 - readVolatileLong
```
public long readVolatileLong()
```
 Description copied from interface: StreamingDataInput
 
 Reads a volatile (concurrently mutable) long value from the input stream.
 
 Specified by:
 
 readVolatileLong in interface StreamingDataInput<Bytes>
 
 Returns:
 
 the read long value
 - writeByte
```
@NotNull
public @NotNull Bytes writeByte(long offset,
 byte i)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Writes a byte at the specified non-negative offset.
 
 Specified by:
 
 writeByte in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - The non-negative position within the data stream to write the byte to.
 
 i - The byte value to write.
 
 Returns:
 
 Reference to the current instance, allowing for method chaining.
 
 Throws:
 
 BufferOverflowException - If the specified offset exceeds the available capacity.
 
 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
 
 IllegalStateException
 - rawWriteByte
```
public Bytes rawWriteByte(byte i8)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes a byte to the data stream without any additional checks or transformations.
 
 Specified by:
 
 rawWriteByte in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 i8 - The byte to be written.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 BufferOverflowException - If there is insufficient space in the buffer.
 
 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
 
 IllegalStateException
 - writeShort
```
@NotNull
public @NotNull Bytes writeShort(long offset,
 short i)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Writes a short integer at the specified non-negative offset.
 
 Specified by:
 
 writeShort in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - The non-negative position within the data stream to write the short integer to.
 
 i - The short integer value to write.
 
 Returns:
 
 Reference to the current instance, allowing for method chaining.
 
 Throws:
 
 BufferOverflowException - If the specified offset exceeds the available capacity.
 
 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
 
 IllegalStateException
 - writeInt
```
@NotNull
public @NotNull Bytes writeInt(long offset,
 int i)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Writes an integer value at the specified non-negative offset.
 
 Specified by:
 
 writeInt in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - The non-negative position within the data stream to write the integer to.
 
 i - The integer value to write.
 
 Returns:
 
 Reference to the current instance, allowing for method chaining.
 
 Throws:
 
 BufferOverflowException - If the specified offset exceeds the available capacity.
 
 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
 
 IllegalStateException
 - writeOrderedInt
```
@NotNull
public @NotNull Bytes writeOrderedInt(long offset,
 int i)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Performs a non-blocking write operation with a memory barrier to ensure order of stores. Writes an integer at the specified non-negative offset.
 
 Specified by:
 
 writeOrderedInt in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - The non-negative position within the data stream to write the integer to.
 
 i - The integer value to write.
 
 Returns:
 
 Reference to the current instance, allowing for method chaining.
 
 Throws:
 
 BufferOverflowException - If the specified offset exceeds the available capacity.
 
 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
 
 IllegalStateException
 - writeLong
```
@NotNull
public @NotNull Bytes writeLong(long offset,
 long i)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Writes a long integer value at the specified non-negative offset.
 
 Specified by:
 
 writeLong in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - The non-negative position within the data stream to write the long integer to.
 
 i - The long integer value to write.
 
 Returns:
 
 Reference to the current instance, allowing for method chaining.
 
 Throws:
 
 BufferOverflowException - If the specified offset exceeds the available capacity.
 
 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
 
 IllegalStateException
 - writeOrderedLong
```
@NotNull
public @NotNull Bytes writeOrderedLong(long offset,
 long i)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Performs a non-blocking write operation with a memory barrier to ensure order of stores. Writes a long integer at the specified non-negative offset.
 
 Specified by:
 
 writeOrderedLong in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - The non-negative position within the data stream to write the long integer to.
 
 i - The long integer value to write.
 
 Returns:
 
 Reference to the current instance, allowing for method chaining.
 
 Throws:
 
 BufferOverflowException - If the specified offset exceeds the available capacity.
 
 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
 
 IllegalStateException
 - writeFloat
```
@NotNull
public @NotNull Bytes writeFloat(long offset,
 float d)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Writes a single-precision floating-point value at the specified non-negative offset.
 
 Specified by:
 
 writeFloat in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - The non-negative position within the data stream to write the float to.
 
 d - The float value to write.
 
 Returns:
 
 Reference to the current instance, allowing for method chaining.
 
 Throws:
 
 BufferOverflowException - If the specified offset exceeds the available capacity.
 
 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
 
 IllegalStateException
 - writeDouble
```
@NotNull
public @NotNull Bytes writeDouble(long offset,
 double d)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Writes a double-precision floating-point value at the specified non-negative offset.
 
 Specified by:
 
 writeDouble in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - The non-negative position within the data stream to write the double to.
 
 d - The double value to write.
 
 Returns:
 
 Reference to the current instance, allowing for method chaining.
 
 Throws:
 
 BufferOverflowException - If the specified offset exceeds the available capacity.
 
 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
 
 IllegalStateException
 - writeVolatileByte
```
@NotNull
public @NotNull Bytes writeVolatileByte(long offset,
 byte i8)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Writes a volatile byte at the specified non-negative offset. The write is volatile, ensuring it is not cached and instantly visible to all threads.
 
 Specified by:
 
 writeVolatileByte in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - The non-negative position within the data stream to write the byte to.
 
 i8 - The byte value to write.
 
 Returns:
 
 Reference to the current instance, allowing for method chaining.
 
 Throws:
 
 BufferOverflowException - If the specified offset exceeds the available capacity.
 
 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
 
 IllegalStateException
 - writeVolatileShort
```
@NotNull
public @NotNull Bytes writeVolatileShort(long offset,
 short i16)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Writes a volatile short at the specified non-negative offset. The write is volatile, ensuring it is not cached and instantly visible to all threads.
 
 Specified by:
 
 writeVolatileShort in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - The non-negative position within the data stream to write the short to.
 
 i16 - The short value to write.
 
 Returns:
 
 Reference to the current instance, allowing for method chaining.
 
 Throws:
 
 BufferOverflowException - If the specified offset exceeds the available capacity.
 
 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
 
 IllegalStateException
 - writeVolatileInt
```
@NotNull
public @NotNull Bytes writeVolatileInt(long offset,
 int i32)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Writes a volatile integer at the specified non-negative offset. The write is volatile, ensuring it is not cached and instantly visible to all threads.
 
 Specified by:
 
 writeVolatileInt in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - The non-negative position within the data stream to write the integer to.
 
 i32 - The integer value to write.
 
 Returns:
 
 Reference to the current instance, allowing for method chaining.
 
 Throws:
 
 BufferOverflowException - If the specified offset exceeds the available capacity.
 
 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
 
 IllegalStateException
 - writeVolatileLong
```
@NotNull
public @NotNull Bytes writeVolatileLong(long offset,
 long i64)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Writes a volatile long integer at the specified non-negative offset. The write is volatile, ensuring it is not cached and instantly visible to all threads.
 
 Specified by:
 
 writeVolatileLong in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offset - The non-negative position within the data stream to write the long integer to.
 
 i64 - The long integer value to write.
 
 Returns:
 
 Reference to the current instance, allowing for method chaining.
 
 Throws:
 
 BufferOverflowException - If the specified offset exceeds the available capacity.
 
 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
 
 IllegalStateException
 - write
```
@NotNull
public @NotNull Bytes write(long offsetInRDO,
 byte[] byteArray,
 int offset,
 int length)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Copies the provided byteArray to this Bytes object starting at writeOffset taking content starting at readOffset but copying at most length bytes.
 Does not update cursors e.g. writePosition()
 
 Specified by:
 
 write in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offsetInRDO - the non-negative offset within the data output where the segment should be written.
 
 byteArray - the byte array containing the segment to be written.
 
 offset - the non-negative offset within the byte array where the segment begins.
 
 length - the non-negative length of the segment.
 
 Returns:
 
 a reference to this instance.
 
 Throws:
 
 BufferOverflowException - If the capacity of this data output was exceeded.
 
 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
 
 IllegalStateException
 - write
```
public void write(long offsetInRDO,
 @NotNull
 @NotNull ByteBuffer bytes,
 int offset,
 int length)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Copies a segment from the provided ByteBuffer into this data output.
 Does not update cursors e.g. writePosition()
 
 Specified by:
 
 write in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 offsetInRDO - the non-negative offset within the data output where the segment should be written.
 
 bytes - the ByteBuffer containing the segment to be written.
 
 offset - the non-negative offset within the ByteBuffer where the segment begins.
 
 length - the non-negative length of the segment.
 
 Throws:
 
 BufferOverflowException - If the capacity of this data output was exceeded.
 
 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
 
 IllegalStateException
 - write
```
@NotNull
public @NotNull Bytes write(long writeOffset,
 @NotNull
 @NotNull RandomDataInput bytes,
 long readOffset,
 long length)
 throws BufferUnderflowException,
 BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: RandomDataOutput
 
 Copies a segment from the provided RandomDataInput into this data output. This operation does not update the writePosition() of this output nor the RandomCommon.readPosition() of the input.
 
 Specified by:
 
 write in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 writeOffset - the non-negative offset within this data output where the segment should be written.
 
 bytes - the RandomDataInput source containing the segment to be written.
 
 readOffset - the non-negative offset within the source where the segment begins.
 
 length - the non-negative length of the segment.
 
 Returns:
 
 a reference to this instance.
 
 Throws:
 
 BufferUnderflowException - If the source does not have enough data to fill the length.
 
 BufferOverflowException - If the capacity of this data output was exceeded.
 
 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
 
 IllegalStateException
 - readByte
```
public byte readByte(long offset)
```
 Description copied from interface: RandomDataInput
 
 Reads a byte value from a specific offset.
 
 Specified by:
 
 readByte in interface RandomDataInput
 
 Parameters:
 
 offset - the location from where the byte value is read.
 
 Returns:
 
 the read byte value.
 - readUnsignedByte
```
public int readUnsignedByte(long offset)
```
 Description copied from interface: RandomDataInput
 
 Reads an unsigned byte value from a specific offset. The value is returned as an int in order to represent the unsigned byte as a positive value.
 
 Specified by:
 
 readUnsignedByte in interface RandomDataInput
 
 Parameters:
 
 offset - the location from where the unsigned byte value is read.
 
 Returns:
 
 the unsigned byte value interpreted as a positive int.
 - peekUnsignedByte
```
public int peekUnsignedByte(long offset)
```
 Description copied from interface: RandomDataInput
 
 Reads an unsigned byte value from a specific offset. Returns -1 if the byte read is at the end of the byte source. The value is returned as an int in order to represent the unsigned byte as a positive value.
 
 Specified by:
 
 peekUnsignedByte in interface RandomDataInput
 
 Parameters:
 
 offset - the location from where the unsigned byte value is read.
 
 Returns:
 
 the unsigned byte value interpreted as a positive int or -1.
 - readShort
```
public short readShort(long offset)
```
 Description copied from interface: RandomDataInput
 
 Reads a short value from a specific offset.
 
 Specified by:
 
 readShort in interface RandomDataInput
 
 Parameters:
 
 offset - the location from where the short value is read.
 
 Returns:
 
 the read short value.
 - readInt
```
public int readInt(long offset)
```
 Description copied from interface: RandomDataInput
 
 Reads a 32-bit integer value from a specific offset.
 
 Specified by:
 
 readInt in interface RandomDataInput
 
 Parameters:
 
 offset - the location from where the 32-bit integer value is read.
 
 Returns:
 
 the read int value.
 - readLong
```
public long readLong(long offset)
```
 Description copied from interface: RandomDataInput
 
 Reads a 64-bit long value from a specific offset.
 
 Specified by:
 
 readLong in interface RandomDataInput
 
 Parameters:
 
 offset - the location from where the long value is read.
 
 Returns:
 
 the read long value.
 - readFloat
```
public float readFloat(long offset)
```
 Description copied from interface: RandomDataInput
 
 Reads a 32-bit floating point value from a specified offset.
 
 Specified by:
 
 readFloat in interface RandomDataInput
 
 Parameters:
 
 offset - the location from where the float value is read.
 
 Returns:
 
 the read float value.
 - readDouble
```
public double readDouble(long offset)
```
 Description copied from interface: RandomDataInput
 
 Reads a 64-bit floating point value from a specified offset.
 
 Specified by:
 
 readDouble in interface RandomDataInput
 
 Parameters:
 
 offset - the location from where the double value is read.
 
 Returns:
 
 the read double value.
 - writeByte
```
@NotNull
public @NotNull Bytes writeByte(byte i8)
```
 Description copied from interface: StreamingDataOutput
 
 Writes a byte to the data stream.
 
 Specified by:
 
 writeByte in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 i8 - The byte to be written.
 
 Returns:
 
 The current StreamingDataOutput instance.
 - prewriteByte
```
@NotNull
public @NotNull Bytes prewriteByte(byte i8)
```
 Description copied from interface: BytesPrepender
 
 Writes a byte backward in binary format. This operation moves the readPosition() backward.
 
 Specified by:
 
 prewriteByte in interface BytesPrepender<Bytes>
 
 Parameters:
 
 i8 - the byte to prepend
 
 Returns:
 
 this instance, after the operation
 - writeShort
```
@NotNull
public @NotNull Bytes writeShort(short i16)
 throws IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes a short integer to the data stream.
 
 Specified by:
 
 writeShort in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 i16 - The short integer to be written.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 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
 
 IllegalStateException
 - prewriteShort
```
@NotNull
public @NotNull Bytes prewriteShort(short i16)
 throws IllegalStateException
```
 Description copied from interface: BytesPrepender
 
 Writes a short (2-byte int) backward in binary format. This operation moves the readPosition() backward.
 
 Specified by:
 
 prewriteShort in interface BytesPrepender<Bytes>
 
 Parameters:
 
 i16 - the short to prepend
 
 Returns:
 
 this instance, after the operation
 
 Throws:
 
 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.
 
 IllegalStateException
 - writeInt
```
@NotNull
public @NotNull Bytes writeInt(int i)
 throws IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes an integer to the data stream.
 
 Specified by:
 
 writeInt in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 i - The integer to be written.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 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
 
 IllegalStateException
 - writeIntAdv
```
@NotNull
public @NotNull Bytes writeIntAdv(int i,
 int advance)
 throws IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes an integer to the data stream, then advances the write position by the specified amount.
 
 Specified by:
 
 writeIntAdv in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 i - The integer to be written.
 
 advance - The number of bytes to advance the write position after the integer has been written.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 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
 
 IllegalStateException
 - prewriteInt
```
@NotNull
public @NotNull Bytes prewriteInt(int i)
 throws IllegalStateException
```
 Description copied from interface: BytesPrepender
 
 Writes an int (4-byte int) backward in binary format. This operation moves the readPosition() backward.
 
 Specified by:
 
 prewriteInt in interface BytesPrepender<Bytes>
 
 Parameters:
 
 i - the int to prepend
 
 Returns:
 
 this instance, after the operation
 
 Throws:
 
 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.
 
 IllegalStateException
 - writeLong
```
@NotNull
public @NotNull Bytes writeLong(long i64)
 throws IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes a long integer to the data stream.
 
 Specified by:
 
 writeLong in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 i64 - The long integer to be written.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 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
 
 IllegalStateException
 - writeLongAdv
```
@NotNull
public @NotNull Bytes writeLongAdv(long i64,
 int advance)
 throws IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes a long integer to the data stream, then advances the write position by the specified amount.
 
 Specified by:
 
 writeLongAdv in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 i64 - The long integer to be written.
 
 advance - The number of bytes to advance the write position after the long integer has been written.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 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
 
 IllegalStateException
 - prewriteLong
```
@NotNull
public @NotNull Bytes prewriteLong(long i64)
 throws IllegalStateException
```
 Description copied from interface: BytesPrepender
 
 Writes a long (8-byte int) backward in binary format. This operation moves the readPosition() backward.
 
 Specified by:
 
 prewriteLong in interface BytesPrepender<Bytes>
 
 Parameters:
 
 i64 - the long to prepend
 
 Returns:
 
 this instance, after the operation
 
 Throws:
 
 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.
 
 IllegalStateException
 - writeFloat
```
@NotNull
public @NotNull Bytes writeFloat(float f)
 throws IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes a floating-point number to the data stream.
 
 Specified by:
 
 writeFloat in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 f - The floating-point number to be written.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 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
 
 IllegalStateException
 - writeDouble
```
@NotNull
public @NotNull Bytes writeDouble(double d)
 throws IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes a double-precision floating-point number to the data stream.
 
 Specified by:
 
 writeDouble in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 d - The double-precision floating-point number to be written.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 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
 
 IllegalStateException
 - writeDoubleAndInt
```
@NotNull
public @NotNull Bytes writeDoubleAndInt(double d,
 int i)
 throws IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes a double-precision floating-point number followed by an integer to the data stream.
 
 Specified by:
 
 writeDoubleAndInt in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 d - The double-precision floating-point number to be written.
 
 i - The integer to be written.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 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
 
 IllegalStateException
 - write
```
@NotNull
public @NotNull Bytes write(byte[] byteArray,
 int offset,
 int length)
 throws BufferOverflowException,
 IllegalStateException,
 ArrayIndexOutOfBoundsException
```
 Description copied from interface: StreamingDataOutput
 
 Writes the specified number of bytes from the given byteArray into the output stream, starting from the given offset. The position of the output stream is updated according to the number of bytes written.
 
 Specified by:
 
 write in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 byteArray - the array of bytes to be written.
 
 offset - the start index in the array from where to start writing bytes.
 
 length - the number of bytes to write.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 BufferOverflowException - If there is not enough space left in the output stream.
 
 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
 
 ArrayIndexOutOfBoundsException - If the provided offset and length combination is invalid.
 
 IllegalStateException
 - prewrite
```
@NotNull
public @NotNull Bytes prewrite(@NotNull
 @NotNull byte[] bytes)
 throws IllegalStateException,
 BufferOverflowException
```
 Description copied from interface: BytesPrepender
 
 Writes a byte array backward in binary format. This operation moves the readPosition() backward.
 
 Specified by:
 
 prewrite in interface BytesPrepender<Bytes>
 
 Parameters:
 
 bytes - the byte array to prepend
 
 Returns:
 
 this instance, after the operation
 
 Throws:
 
 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.
 
 BufferOverflowException - If the capacity of the underlying buffer was exceeded
 
 IllegalStateException
 - prewrite
```
@NotNull
public @NotNull Bytes prewrite(@NotNull
 @NotNull BytesStore bytes)
 throws IllegalStateException,
 BufferOverflowException
```
 Description copied from interface: BytesPrepender
 
 Writes a BytesStore instance backward in binary format. This operation moves the readPosition() backward.
 
 Specified by:
 
 prewrite in interface BytesPrepender<Bytes>
 
 Parameters:
 
 bytes - the BytesStore to prepend
 
 Returns:
 
 this instance, after the operation
 
 Throws:
 
 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.
 
 BufferOverflowException - If the capacity of the underlying buffer was exceeded
 
 IllegalStateException
 - writeSome
```
@NotNull
public @NotNull Bytes writeSome(@NotNull
 @NotNull ByteBuffer buffer)
 throws IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes the available data from the provided ByteBuffer into this Bytes object. The number of bytes written is constrained by the space available in this Bytes object. The position of this Bytes object is updated according to the number of bytes written.
 
 Specified by:
 
 writeSome in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 buffer - the ByteBuffer from which data is read.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 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
 
 IllegalStateException
 - writeOrderedInt
```
@NotNull
public @NotNull Bytes writeOrderedInt(int i)
 throws IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes an integer value to this output stream using an ordered-writing mechanism. Ordered writing ensures that the integer is written with a write memory barrier.
 
 Specified by:
 
 writeOrderedInt in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 i - The integer value to be written.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 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
 
 IllegalStateException
 - writeOrderedLong
```
@NotNull
public @NotNull Bytes writeOrderedLong(long i)
 throws IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes a long value to this output stream using an ordered-writing mechanism. Ordered writing ensures that the integer is written with a write memory barrier.
 
 Specified by:
 
 writeOrderedLong in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 i - The long value to be written.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 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
 
 IllegalStateException
 - addressForRead
```
public long addressForRead(long offset)
 throws BufferUnderflowException
```
 Retrieves the underlying memory address for reading. 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:
 
 BufferUnderflowException - If the offset is before the start() or the after the capacity()
 - addressForWrite
```
public long addressForWrite(long offset)
 throws BufferOverflowException
```
 Retrieves the underlying memory address for writing. 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:
 
 BufferOverflowException - If the offset is before the start() or the after the capacity()
 - addressForWritePosition
```
public long addressForWritePosition()
 throws UnsupportedOperationException,
 BufferOverflowException
```
 Retrieves the underlying memory address for writing at the current write position. This is for expert users only.
 
 Returns:
 
 The underlying memory address for writing at the current write position.
 
 Throws:
 
 UnsupportedOperationException - If the underlying buffer is on the heap.
 
 BufferOverflowException - If the current write position is before the start or after the capacity.
 - hashCode
```
public int hashCode()
```
 Overrides:
 
 hashCode in class Object
 - equals
```
public boolean equals(Object obj)
```
 Overrides:
 
 equals in class Object
 - toString
```
@NotNull
public @NotNull String toString()
```
 Specified by:
 
 toString in interface CharSequence
 
 Overrides:
 
 toString in class net.openhft.chronicle.core.io.AbstractReferenceCounted
 - lenient
```
public void lenient(boolean lenient)
```
 Description copied from interface: StreamingDataInput
 
 When there is no more data to read, return zero, false and empty string.
 
 Specified by:
 
 lenient in interface StreamingDataInput<Bytes>
 
 Parameters:
 
 lenient - if true, return nothing rather than error.
 - lenient
```
public boolean lenient()
```
 Specified by:
 
 lenient in interface StreamingDataInput<Bytes>
 - nativeRead
```
public void nativeRead(long position,
 long address,
 long size)
 throws IllegalStateException,
 BufferUnderflowException
```
 Description copied from interface: RandomDataInput
 
 Expert-level method for transferring data from this byte source to native memory.
 
 Specified by:
 
 nativeRead in interface RandomDataInput
 
 Parameters:
 
 position - the starting point within the byte source from which data is copied.
 
 address - the destination address in native memory.
 
 size - the number of bytes to transfer.
 
 Throws:
 
 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
 
 BufferUnderflowException - If the specified position or size exceeds the byte source limits.
 
 IllegalStateException
 - nativeWrite
```
public void nativeWrite(long address,
 long position,
 long size)
 throws IllegalStateException,
 BufferOverflowException
```
 Description copied from interface: RandomDataOutput
 
 Expert-level method that copies data directly from native memory into this BytesStore.
 
 Specified by:
 
 nativeWrite in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 address - the address in the native memory from where data should be copied.
 
 position - the position in the BytesStore where data should be written.
 
 size - the size of the data, in bytes, to be copied from the native memory.
 
 Throws:
 
 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
 
 BufferOverflowException - If the capacity of this BytesStore was exceeded.
 
 IllegalStateException
 - bytesStore
```
@Nullable
public @Nullable BytesStore bytesStore()
```
 Description copied from interface: Bytes
 
 Returns the backing BytesStore that this Bytes object wraps. If this Bytes object doesn't have a backing BytesStore, this method returns null.
 The BytesStore represents the underlying storage of bytes that the Bytes object is manipulating.
 
 Specified by:
 
 bytesStore in interface Bytes
 
 Specified by:
 
 bytesStore in interface BytesStore<Bytes,U>
 
 Returns:
 
 The backing BytesStore, or null if there isn't one.
 - byteCheckSum
```
public int byteCheckSum()
 throws net.openhft.chronicle.core.io.IORuntimeException
```
 Description copied from interface: BytesStore
 
 Returns the bytes sum of the readable bytes in this BytesStore.
 
 Specified by:
 
 byteCheckSum in interface BytesStore<Bytes,U>
 
 Returns:
 
 unsigned bytes sum
 
 Throws:
 
 net.openhft.chronicle.core.io.IORuntimeException
 - append8bit
```
@NotNull
public @NotNull Bytes append8bit(@NotNull
 @NotNull CharSequence cs)
 throws BufferOverflowException,
 BufferUnderflowException,
 IllegalStateException
```
 Description copied from interface: ByteStringAppender
 
 Appends a String to the Bytes in ISO-8859-1.
 
 Specified by:
 
 append8bit in interface ByteStringAppender<Bytes>
 
 Parameters:
 
 cs - the CharSequence to append
 
 Returns:
 
 this
 
 Throws:
 
 BufferOverflowException - If the string is too large to write in the capacity available
 
 BufferUnderflowException - If the capacity of the underlying buffer was exceeded
 
 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.
 
 IllegalStateException
 - appendUtf8
```
@NotNull
public @NotNull Bytes appendUtf8(char[] chars,
 int offset,
 int length)
 throws BufferOverflowException,
 IllegalArgumentException,
 IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Appends a UTF-8 encoded CharSequence to this output stream from a specific offset and length.
 
 Specified by:
 
 appendUtf8 in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 chars - The CharSequence to be appended.
 
 offset - The offset from which to start writing the CharSequence.
 
 length - The number of characters from the CharSequence to write.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 BufferOverflowException - If there is not enough space left in the output stream.
 
 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
 
 IllegalArgumentException
 
 IllegalStateException
 - append
```
@NotNull
public @NotNull UncheckedNativeBytes append(double d)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: ByteStringAppender
 
 Appends a double in decimal notation
 
 Specified by:
 
 append in interface ByteStringAppender<Bytes>
 
 Parameters:
 
 d - to append
 
 Returns:
 
 this
 
 Throws:
 
 BufferOverflowException - If the capacity of the underlying buffer was exceeded
 
 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.
 
 IllegalStateException
 - append
```
@NotNull
public @NotNull UncheckedNativeBytes append(float f)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: ByteStringAppender
 
 Appends a float in decimal notation
 
 Specified by:
 
 append in interface ByteStringAppender<Bytes>
 
 Parameters:
 
 f - the float number to append
 
 Returns:
 
 this
 
 Throws:
 
 BufferOverflowException - If the relative append operation exceeds the underlying buffer's capacity
 
 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.
 
 IllegalStateException
 - append
```
@NotNull
public @NotNull Bytes append(int value)
 throws BufferOverflowException,
 IllegalArgumentException,
 IllegalStateException
```
 Description copied from interface: ByteStringAppender
 
 Appends an int in decimal to this.
 
 Specified by:
 
 append in interface ByteStringAppender<Bytes>
 
 Parameters:
 
 value - the integer value to append
 
 Returns:
 
 this
 
 Throws:
 
 BufferOverflowException - If the relative append operation exceeds the underlying buffer's capacity
 
 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.
 
 IllegalArgumentException
 
 IllegalStateException
 - append
```
@NotNull
public @NotNull Bytes append(long value)
 throws BufferOverflowException,
 IllegalStateException
```
 Description copied from interface: ByteStringAppender
 
 Appends a long value in decimal.
 
 Specified by:
 
 append in interface ByteStringAppender<Bytes>
 
 Parameters:
 
 value - the long number to append
 
 Returns:
 
 this
 
 Throws:
 
 BufferOverflowException - If the relative append operation exceeds the underlying buffer's capacity
 
 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.
 
 IllegalStateException
 - decimaliser
```
public Decimaliser decimaliser()
```
 Description copied from interface: ByteStringAppender
 
 Gets the Decimaliser currently associated with this ByteStringAppender.
 
 Specified by:
 
 decimaliser in interface ByteStringAppender<Bytes>
 
 Returns:
 
 The Decimaliser currently associated with this ByteStringAppender.
 - decimaliser
```
public Bytes decimaliser(Decimaliser decimaliser)
```
 Description copied from interface: ByteStringAppender
 
 Associates a Decimaliser with this ByteStringAppender.
 The Decimaliser is an interface which can be implemented to provide custom logic for rendering decimal numbers in this ByteStringAppender.
 
 Specified by:
 
 decimaliser in interface ByteStringAppender<Bytes>
 
 Parameters:
 
 decimaliser - The Decimaliser to be associated with this ByteStringAppender.
 
 Returns:
 
 The ByteStringAppender instance with the Decimaliser set.
 - fpAppend0
```
public boolean fpAppend0()
```
 Specified by:
 
 fpAppend0 in interface ByteStringAppender<Bytes>
 
 Returns:
 
 whether floating point add .0 to indicate it is a floating point even if redundant.
 - fpAppend0
```
public Bytes fpAppend0(boolean append0)
```
 Specified by:
 
 fpAppend0 in interface ByteStringAppender<Bytes>
 
 Parameters:
 
 append0 - Does floating point add .0 to indicate it is a floating point even if redundant.
 
 Returns:
 
 this
 - append
```
public void append(boolean negative,
 long mantissa,
 int exponent)
```
 Description copied from interface: DecimalAppender
 
 Appends a decimal number, represented by its sign, mantissa, and exponent, to a target. The target can be any object that consumes these components, such as a StringBuilder or a file stream.
 
 Specified by:
 
 append in interface DecimalAppender
 
 Parameters:
 
 negative - Whether the number is negative. true indicates a negative number, false indicates a positive number.
 
 mantissa - The significant digits of the decimal number, represented as a long integer.
 
 exponent - The power of 10 by which the mantissa is scaled to obtain the actual decimal number.
 - appendAndReturnLength
```
public long appendAndReturnLength(long writePosition,
 boolean negative,
 long mantissa,
 int exponent,
 boolean append0)
```
 Specified by:
 
 appendAndReturnLength in interface RandomDataOutput<Bytes>
 - lastDecimalPlaces
```
public int lastDecimalPlaces()
```
 Description copied from interface: ByteStringParser
 
 Returns the number of decimal places in the last parsed floating-point number (from the ByteStringParser.parseDouble() or ByteStringParser.parseLongDecimal() methods).
 
 Specified by:
 
 lastDecimalPlaces in interface ByteStringParser<Bytes>
 
 Returns:
 
 the number of decimal places in the last parsed number.
 - lastDecimalPlaces
```
public void lastDecimalPlaces(int lastDecimalPlaces)
```
 Description copied from interface: ByteStringParser
 
 Sets the number of decimal places in the last parsed number. If the given value is positive, it is directly set; otherwise, the decimal place count is set to 0.
 
 Specified by:
 
 lastDecimalPlaces in interface ByteStringParser<Bytes>
 
 Parameters:
 
 lastDecimalPlaces - the number of decimal places to set, if positive; otherwise 0.
 - lastNumberHadDigits
```
public boolean lastNumberHadDigits()
```
 Description copied from interface: ByteStringParser
 
 Returns whether the last parsed number had any digits.
 
 Specified by:
 
 lastNumberHadDigits in interface ByteStringParser<Bytes>
 
 Returns:
 
 true if the last parsed number had digits, false otherwise.
 - lastNumberHadDigits
```
public void lastNumberHadDigits(boolean lastNumberHadDigits)
```
 Description copied from interface: ByteStringParser
 
 Sets whether the last parsed number had any digits.
 
 Specified by:
 
 lastNumberHadDigits in interface ByteStringParser<Bytes>
 
 Parameters:
 
 lastNumberHadDigits - the new value to set, true if the last parsed number had digits, false otherwise.
 - write
```
@NotNull
public @NotNull Bytes write(@NotNull
 @NotNull RandomDataInput bytes)
 throws IllegalStateException
```
 Description copied from interface: StreamingDataOutput
 
 Writes all available data from the specified RandomDataInput into the output stream. The position of this output stream is updated accordingly, but the read position of the input data is not changed. The operation will fail if there is not enough space left in the output stream.
 
 Specified by:
 
 write in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 bytes - the RandomDataInput from which data is read.
 
 Returns:
 
 The current StreamingDataOutput instance.
 
 Throws:
 
 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
 
 IllegalStateException
 - write8bit
```
public long write8bit(long position,
 @NotNull
 @NotNull BytesStore bs)
```
 Description copied from interface: RandomDataOutput
 
 Writes a BytesStore instance to this RandomDataOutput at the given position. The length of the BytesStore content is encoded using a stop bit encoding scheme.
 
 Specified by:
 
 write8bit in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 position - the position at which the BytesStore content should be written.
 
 bs - the BytesStore instance to write.
 
 Returns:
 
 the offset after the BytesStore has been written.
 - write8bit
```
public long write8bit(long position,
 @NotNull
 @NotNull String s,
 int start,
 int length)
```
 Description copied from interface: RandomDataOutput
 
 Writes a portion of a string to this RandomDataOutput at the given position. The length of the string is encoded using a stop bit encoding scheme.
 
 Specified by:
 
 write8bit in interface RandomDataOutput<Bytes>
 
 Parameters:
 
 position - the position at which the string should be written.
 
 s - the string to write.
 
 start - the starting index from where characters are to be taken from the string.
 
 length - the number of characters to be written from the string.
 
 Returns:
 
 the offset after the string has been written.
 - write8bit
```
public Bytes write8bit(@Nullable
 @Nullable BytesStore bs)
 throws BufferOverflowException,
 IllegalStateException,
 BufferUnderflowException
```
 Throws:
 
 BufferOverflowException
 
 IllegalStateException
 
 BufferUnderflowException
 - write8bit
```
@NotNull
public @NotNull Bytes write8bit(@NotNull
 @NotNull String text,
 int start,
 int length)
```
 Description copied from interface: StreamingDataOutput
 
 Writes a subsequence of a String as an 8-bit string to the data stream. This method is to be implemented by concrete subclasses.
 
 Specified by:
 
 write8bit in interface StreamingDataOutput<Bytes>
 
 Parameters:
 
 text - The String to be written.
 
 start - The index of the first char in the String to write.
 
 length - The number of chars from the String to write.
 
 Returns:
 
 The current StreamingDataOutput instance.
 - acquireUncheckedInput
```
@NotNull
public @NotNull UncheckedRandomDataInput acquireUncheckedInput()
```
 Description copied from interface: HasUncheckedRandomDataInput
 
 Returns a view of a memory segment providing memory read operations with potentially unchecked memory boundaries.
 
 Specified by:
 
 acquireUncheckedInput in interface HasUncheckedRandomDataInput
 
 Returns:
 
 an unchecked view
 - internalNumberBuffer
```
@Deprecated
public byte[] internalNumberBuffer()
```
 Deprecated.
 
 Specified by:
 
 internalNumberBuffer in interface ByteStringAppender<Bytes>
 
 Specified by:
 
 internalNumberBuffer in interface RandomDataOutput<Bytes>
 
 Specified by:
 
 internalNumberBuffer in interface StreamingDataOutput<Bytes>

Class UncheckedNativeBytes<U>

Field Summary

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

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

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

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

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

Constructor Summary

Method Summary

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

Methods inherited from class java.lang.Object

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

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

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

Methods inherited from interface java.lang.CharSequence

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

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

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

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

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

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

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

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

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

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

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

Field Detail

capacity

bytesStore

readPosition

writePosition

writeLimit

Constructor Detail

UncheckedNativeBytes

Method Detail

ensureCapacity

unchecked

isDirectMemory

unchecked

move

compact

readPosition

readLimit

writePosition

readSkip

readVolatileByte

readVolatileShort

readVolatileInt

readVolatileLong

uncheckedReadSkipOne

uncheckedReadSkipBackOne

writeSkip

writeLimit

copy

isElastic

readOffsetPositionMoved

writeOffsetPositionMoved

writeOffsetPositionMoved

prewriteOffsetPositionMoved

write

rawCopy

clear

clearAndPad

readLimit

writeLimit

realCapacity

realWriteRemaining

capacity

underlyingObject

readPosition

writePosition

compareAndSwapInt

testAndSetInt

compareAndSwapLong

performRelease

readUnsignedByte

uncheckedReadUnsignedByte

readByte

peekUnsignedByte

readShort