org.agrona

Interface MutableDirectBuffer

All Superinterfaces:

java.lang.Comparable<DirectBuffer>, DirectBuffer

All Known Subinterfaces:

AtomicBuffer

All Known Implementing Classes:

ExpandableArrayBuffer, UnsafeBuffer

public interface MutableDirectBuffer
extends DirectBuffer

Abstraction over a range of buffer types that allows fields to be written in native typed fashion.

Method Summary

Modifier and Type	Method and Description
boolean	isExpandable() Is this buffer expandable to accommodate putting data into it beyond the current capacity?
void	putByte(int index, byte value) Put a value to a given index.
void	putBytes(int index, byte[] src) Put an array of src into the underlying buffer.
void	putBytes(int index, byte[] src, int offset, int length) Put an array into the underlying buffer.
void	putBytes(int index, java.nio.ByteBuffer srcBuffer, int length) Put bytes into the underlying buffer for the view.
void	putBytes(int index, java.nio.ByteBuffer srcBuffer, int srcIndex, int length) Put bytes into the underlying buffer for the view.
void	putBytes(int index, DirectBuffer srcBuffer, int srcIndex, int length) Put bytes from a source DirectBuffer into this MutableDirectBuffer at given indices.
void	putChar(int index, char value) Put a value to a given index.
void	putChar(int index, char value, java.nio.ByteOrder byteOrder) Put a value to a given index.
void	putDouble(int index, double value) Put a value to a given index.
void	putDouble(int index, double value, java.nio.ByteOrder byteOrder) Put a value to a given index.
void	putFloat(int index, float value) Put a value to a given index.
void	putFloat(int index, float value, java.nio.ByteOrder byteOrder) Put a value to a given index.
void	putInt(int index, int value) Put a value to a given index.
void	putInt(int index, int value, java.nio.ByteOrder byteOrder) Put a value to a given index.
void	putLong(int index, long value) Put a value to a given index.
void	putLong(int index, long value, java.nio.ByteOrder byteOrder) Put a value to a given index.
void	putShort(int index, short value) Put a value to a given index.
void	putShort(int index, short value, java.nio.ByteOrder byteOrder) Put a value to a given index.
int	putStringUtf8(int index, java.lang.String value) Encode a String as UTF-8 bytes to the buffer with a length prefix.
int	putStringUtf8(int index, java.lang.String value, java.nio.ByteOrder byteOrder) Encode a String as UTF-8 bytes to the buffer with a length prefix.
int	putStringUtf8(int index, java.lang.String value, java.nio.ByteOrder byteOrder, int maxEncodedSize) Encode a String as UTF-8 bytes the buffer with a length prefix with a maximum encoded size check.
int	putStringUtf8(int index, java.lang.String value, int maxEncodedSize) Encode a String as UTF-8 bytes the buffer with a length prefix with a maximum encoded size check.
int	putStringWithoutLengthUtf8(int index, java.lang.String value) Encode a String as UTF-8 bytes in the buffer without a length prefix.
void	setMemory(int index, int length, byte value) Set a region of memory to a given byte value.

Methods inherited from interface org.agrona.DirectBuffer

addressOffset, boundsCheck, byteArray, byteBuffer, capacity, checkLimit, getByte, getBytes, getBytes, getBytes, getBytes, getBytes, getChar, getChar, getDouble, getDouble, getFloat, getFloat, getInt, getInt, getLong, getLong, getShort, getShort, getStringUtf8, getStringUtf8, getStringUtf8, getStringWithoutLengthUtf8, wrap, wrap, wrap, wrap, wrap, wrap, wrap, wrapAdjustment

Methods inherited from interface java.lang.Comparable

compareTo

Method Detail

isExpandable

boolean isExpandable()

Is this buffer expandable to accommodate putting data into it beyond the current capacity?

Returns:

true is the underlying storage can expand otherwise false.

setMemory

void setMemory(int index,
               int length,
               byte value)

Set a region of memory to a given byte value.

Parameters:

index - at which to start.

length - of the run of bytes to set.

value - the memory will be set to.

putLong

void putLong(int index,
             long value,
             java.nio.ByteOrder byteOrder)

Put a value to a given index.

Parameters:

index - in bytes for where to put.

value - for at a given index

byteOrder - of the value when written

putLong

void putLong(int index,
             long value)

Put a value to a given index.

Parameters:

index - in bytes for where to put.

value - for at a given index

putInt

void putInt(int index,
            int value,
            java.nio.ByteOrder byteOrder)

Put a value to a given index.

Parameters:

index - in bytes for where to put.

value - to be written

byteOrder - of the value when written

putInt

void putInt(int index,
            int value)

Put a value to a given index.

Parameters:

index - in bytes for where to put.

value - for at a given index

putDouble

void putDouble(int index,
               double value,
               java.nio.ByteOrder byteOrder)

Put a value to a given index.

Parameters:

index - in bytes for where to put.

value - to be written

byteOrder - of the value when written.

putDouble

void putDouble(int index,
               double value)

Put a value to a given index.

Parameters:

index - in bytes for where to put.

value - to be written

putFloat

void putFloat(int index,
              float value,
              java.nio.ByteOrder byteOrder)

Put a value to a given index.

Parameters:

index - in bytes for where to put.

value - to be written

byteOrder - of the value when written.

putFloat

void putFloat(int index,
              float value)

Put a value to a given index.

Parameters:

index - in bytes for where to put.

value - to be written

putShort

void putShort(int index,
              short value,
              java.nio.ByteOrder byteOrder)

Put a value to a given index.

Parameters:

index - in bytes for where to put.

value - to be written

byteOrder - of the value when written.

putShort

void putShort(int index,
              short value)

Put a value to a given index.

Parameters:

index - in bytes for where to put.

value - to be written

putChar

void putChar(int index,
             char value,
             java.nio.ByteOrder byteOrder)

Put a value to a given index.

Parameters:

index - in bytes for where to put.

value - to be written

byteOrder - of the value when written.

putChar

void putChar(int index,
             char value)

Put a value to a given index.

Parameters:

index - in bytes for where to put.

value - to be written

putByte

void putByte(int index,
             byte value)

Put a value to a given index.

Parameters:

index - in bytes for where to put.

value - to be written

putBytes

void putBytes(int index,
              byte[] src)

Put an array of src into the underlying buffer.

Parameters:

index - in the underlying buffer to start from.

src - to be copied to the underlying buffer.

putBytes

void putBytes(int index,
              byte[] src,
              int offset,
              int length)

Put an array into the underlying buffer.

Parameters:

index - in the underlying buffer to start from.

src - to be copied to the underlying buffer.

offset - in the supplied buffer to begin the copy.

length - of the supplied buffer to copy.

putBytes

void putBytes(int index,
              java.nio.ByteBuffer srcBuffer,
              int length)

Put bytes into the underlying buffer for the view. Bytes will be copied from current Buffer.position() for a given length. The source buffer will have its Buffer.position() advanced as a result.

Parameters:

index - in the underlying buffer to start from.

srcBuffer - to copy the bytes from.

length - of the supplied buffer to copy.

putBytes

void putBytes(int index,
              java.nio.ByteBuffer srcBuffer,
              int srcIndex,
              int length)

Put bytes into the underlying buffer for the view. Bytes will be copied from the buffer index to the buffer index + length. The source buffer will not have its Buffer.position() advanced as a result.

Parameters:

index - in the underlying buffer to start from.

srcBuffer - to copy the bytes from (does not change position).

srcIndex - in the source buffer from which the copy will begin.

length - of the bytes to be copied.

putBytes

void putBytes(int index,
              DirectBuffer srcBuffer,
              int srcIndex,
              int length)

Put bytes from a source DirectBuffer into this MutableDirectBuffer at given indices.

Parameters:

index - in this buffer to begin putting the bytes.

srcBuffer - from which the bytes will be copied.

srcIndex - in the source buffer from which the byte copy will begin.

length - of the bytes to be copied.

putStringUtf8

int putStringUtf8(int index,
                  java.lang.String value)

Encode a String as UTF-8 bytes to the buffer with a length prefix.

Parameters:

index - at which the String should be encoded.

value - of the String to be encoded.

Returns:

the number of bytes put to the buffer.

putStringUtf8

int putStringUtf8(int index,
                  java.lang.String value,
                  java.nio.ByteOrder byteOrder)

Encode a String as UTF-8 bytes to the buffer with a length prefix.

Parameters:

index - at which the String should be encoded.

value - of the String to be encoded.

byteOrder - for the length prefix.

Returns:

the number of bytes put to the buffer.

putStringUtf8

int putStringUtf8(int index,
                  java.lang.String value,
                  int maxEncodedSize)

Encode a String as UTF-8 bytes the buffer with a length prefix with a maximum encoded size check.

Parameters:

index - at which the String should be encoded.

value - of the String to be encoded.

maxEncodedSize - to be checked before writing to the buffer.

Returns:

the number of bytes put to the buffer.

Throws:

java.lang.IllegalArgumentException - if the encoded bytes are greater than maxEncodedSize.

putStringUtf8

int putStringUtf8(int index,
                  java.lang.String value,
                  java.nio.ByteOrder byteOrder,
                  int maxEncodedSize)

Encode a String as UTF-8 bytes the buffer with a length prefix with a maximum encoded size check.

Parameters:

index - at which the String should be encoded.

value - of the String to be encoded.

byteOrder - for the length prefix.

maxEncodedSize - to be checked before writing to the buffer.

Returns:

the number of bytes put to the buffer.

Throws:

java.lang.IllegalArgumentException - if the encoded bytes are greater than maxEncodedSize.

putStringWithoutLengthUtf8

int putStringWithoutLengthUtf8(int index,
                               java.lang.String value)

Encode a String as UTF-8 bytes in the buffer without a length prefix.

Parameters:

index - at which the String begins.

value - of the String to be encoded.

Returns:

the number of bytes encoded.