StreamingDataOutput (OpenHFT/Chronicle-Bytes 2.19.48 API)

All Superinterfaces:

StreamingCommon<S>

All Known Subinterfaces:

Bytes<Underlying>, BytesOut<Underlying>, ByteStringAppender<B>

All Known Implementing Classes:

AbstractBytes, GuardedNativeBytes, HexDumpBytes, MappedBytes, NativeBytes, NativeBytes.NativeSubBytes, OnHeapBytes, SubBytes, UncheckedBytes, UncheckedNativeBytes, VanillaBytes
```
public interface StreamingDataOutput<S extends StreamingDataOutput<S>>
extends StreamingCommon<S>
```
Position based access. Once data has been read, the position() moves.
The use of this instance is single threaded, though the use of the data

Field Summary

Fields
Modifier and Type Field and Description

static int JAVA9_STRING_CODER_LATIN

static int JAVA9_STRING_CODER_UTF16
- Fields inherited from interface net.openhft.chronicle.core.io.ReferenceOwner
  INIT

Fields
Modifier and Type	Field and Description
`static int`	`JAVA9_STRING_CODER_LATIN`
`static int`	`JAVA9_STRING_CODER_UTF16`

Method Summary

All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`long`	`addressForRead(long offset)` Obtain the underlying addressForRead.
`default long`	`addressForRead(long offset, int buffer)`
`long`	`addressForWrite(long offset)` Obtain the underlying addressForRead.
`long`	`addressForWritePosition()`
`default S`	`alignBy(int width)`
`default S`	`appendUtf8(byte[] bytes, int offset, int length)`
`default S`	`appendUtf8(byte[] bytes, int offset, int length, byte coder)`
`default S`	`appendUtf8(char[] chars, int offset, int length)`
`default S`	`appendUtf8(@NotNull CharSequence cs)`
`default S`	`appendUtf8(@NotNull CharSequence cs, int offset, int length)`
`default S`	`appendUtf8(int codepoint)`
`default ByteOrder`	`byteOrder()`
`@NotNull Bytes`	`bytesForRead()`
`@NotNull Bytes`	`bytesForWrite()`
`default boolean`	`canWriteDirect(long count)`
`default long`	`capacity()`
`default boolean`	`compareAndSwapDouble(long offset, double expected, double value)` Perform a 64-bit double CAS at a given offset.
`default boolean`	`compareAndSwapFloat(long offset, float expected, float value)` Perform a 32-bit float CAS at a given offset.
`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.
`default void`	`copyFrom(@NotNull InputStream input)`
`boolean`	`isDirectMemory()`
`void`	`nativeWrite(long address, long size)` Deprecated.
`default @NotNull OutputStream`	`outputStream()`
`default S`	`rawWriteByte(byte i8)`
`default S`	`rawWriteInt(int i)`
`default long`	`readLimit()`
`default long`	`readPosition()` The read position must be start() <= readPosition() && readPosition() <= readLimit() && readPosition < safeLimit()
`default long`	`readRemaining()`
`long`	`realCapacity()`
`long`	`realWriteRemaining()`
`boolean`	`sharedMemory()`
`default long`	`start()`
`void`	`testAndSetInt(long offset, int expected, int value)`
`default S`	`write(@NotNull byte[] bytes)`
`S`	`write(byte[] bytes, int offset, int length)` Write all data or fail.
`default S`	`write(@NotNull BytesStore bytes)`
`default S`	`write(@NotNull BytesStore bytes, long offset, long length)` Write all data or fail.
`default S`	`write(CharSequence cs)`
`default S`	`write(@NotNull CharSequence s, int start, int length)`
`default S`	`write(@NotNull RandomDataInput bytes)` Write all data or fail.
`default S`	`write(@NotNull RandomDataInput bytes, long offset, long length)` Write all data or fail.
`default S`	`write8bit(@Nullable BytesStore bs)`
`default S`	`write8bit(@Nullable CharSequence cs)`
`default S`	`write8bit(@NotNull CharSequence s, int start, int length)`
`default S`	`write8bit(@Nullable String s)`
`default void`	`writeBigDecimal(@NotNull BigDecimal bd)`
`default void`	`writeBigInteger(@NotNull BigInteger bi)`
`default S`	`writeBoolean(boolean flag)`
`S`	`writeByte(byte i8)`
`default S`	`writeChar(char ch)`
`S`	`writeDouble(double d)`
`S`	`writeDoubleAndInt(double d, int i)`
`default <E extends Enum<E>> S`	`writeEnum(E e)`
`S`	`writeFloat(float f)`
`default void`	`writeHistogram(@NotNull net.openhft.chronicle.core.util.Histogram histogram)`
`S`	`writeInt(int i)`
`default S`	`writeInt24(int i)`
`S`	`writeIntAdv(int i, int advance)`
`default long`	`writeLimit()`
`S`	`writeLimit(long limit)`
`S`	`writeLong(long i64)`
`S`	`writeLongAdv(long i64, int advance)`
`S`	`writeOrderedInt(int i)`
`S`	`writeOrderedLong(long i)`
`default long`	`writePosition()` The read position must be readPosition() <= writePosition() && writePosition() <= writeLimit()
`S`	`writePosition(long position)`
`default void`	`writePositionRemaining(long position, long length)`
`default long`	`writeRemaining()`
`S`	`writeShort(short i16)`
`S`	`writeSkip(long bytesToSkip)` Skip a number of bytes by moving the writePosition.
`S`	`writeSome(ByteBuffer buffer)`
`default S`	`writeSome(@NotNull Bytes bytes)`
`default S`	`writeStopBit(char x)`
`default S`	`writeStopBit(double d)`
`default S`	`writeStopBit(long x)` Write a stop bit encoded long
`default S`	`writeStopBitDecimal(double d)`
`default S`	`writeUnsignedByte(int i)`
`default S`	`writeUnsignedInt(long i)`
`default S`	`writeUnsignedInt24(int i)`
`default S`	`writeUnsignedShort(int u16)`
`default S`	`writeUtf8(CharSequence cs)` Write the same encoding as `writeUTF` with the following changes.
`default S`	`writeUtf8(String s)`
`default S`	`writeUTFΔ(CharSequence cs)` Deprecated.
`default void`	`writeWithLength(RandomDataInput bytes)`

Methods inherited from interface net.openhft.chronicle.bytes.StreamingCommon
clear

Methods inherited from interface net.openhft.chronicle.core.io.ReferenceCounted
refCount, release, releaseLast, releaseLast, reserve, reservedBy, reserveTransfer, tryReserve

Methods inherited from interface net.openhft.chronicle.core.io.ReferenceOwner
referenceId, referenceName, temporary

Field Detail
- JAVA9_STRING_CODER_LATIN
```
static final int JAVA9_STRING_CODER_LATIN
```
  See Also:
  
  Constant Field Values
- JAVA9_STRING_CODER_UTF16
```
static final int JAVA9_STRING_CODER_UTF16
```
  See Also:
  
  Constant Field Values

Method Detail

writePosition

@NotNull
S writePosition(long position)
                  throws BufferOverflowException

Throws:: BufferOverflowException

writeLimit

@NotNull
S writeLimit(long limit)
               throws BufferOverflowException

Throws:: BufferOverflowException

writeSkip
```
@NotNull
S writeSkip(long bytesToSkip)
              throws BufferOverflowException
```
Skip a number of bytes by moving the writePosition. Must be less than or equal to the writeLimit.

Parameters:

bytesToSkip - bytes to skip.

Returns:

this

Throws:

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

alignBy
```
default S alignBy(int width)
```

outputStream

@NotNull
default @NotNull OutputStream outputStream()

Returns:: Bytes as an OutputStream

writeStopBit
```
@NotNull
default S writeStopBit(long x)
                         throws BufferOverflowException
```
Write a stop bit encoded long

Parameters:

x - long to write

Returns:

this.

Throws:

BufferOverflowException

writeStopBit

@NotNull
default S writeStopBit(char x)
                         throws BufferOverflowException

Throws:: BufferOverflowException

writeStopBit

@NotNull
default S writeStopBit(double d)
                         throws BufferOverflowException

Throws:: BufferOverflowException

writeStopBitDecimal

@NotNull
default S writeStopBitDecimal(double d)
                                throws BufferOverflowException

Throws:: BufferOverflowException

writeUtf8
```
@NotNull
default S writeUtf8(CharSequence cs)
                      throws BufferOverflowException
```
Write the same encoding as writeUTF with the following changes. 1) The length is stop bit encoded i.e. one byte longer for short strings, but is not limited in length. 2) The string can be null.

Parameters:

cs - the string value to be written. Can be null.

Throws:

BufferOverflowException - if there is not enough space left

writeUtf8

@NotNull
default S writeUtf8(String s)
                      throws BufferOverflowException

Throws:: BufferOverflowException

writeUTFΔ

@NotNull
 @Deprecated
default S writeUTFΔ(CharSequence cs)
                                   throws BufferOverflowException

Deprecated.

Throws:: BufferOverflowException

write8bit

@NotNull
default S write8bit(@Nullable
                             @Nullable CharSequence cs)
                      throws BufferOverflowException

Throws:: BufferOverflowException

write8bit

@NotNull
default S write8bit(@NotNull
                             @NotNull CharSequence s,
                             int start,
                             int length)
                      throws BufferOverflowException,
                             IllegalArgumentException,
                             IndexOutOfBoundsException

Throws:: BufferOverflowException; IllegalArgumentException; IndexOutOfBoundsException

write

@NotNull
default S write(CharSequence cs)
                  throws BufferOverflowException,
                         BufferUnderflowException,
                         IllegalArgumentException

Throws:: BufferOverflowException; BufferUnderflowException; IllegalArgumentException

write

@NotNull
default S write(@NotNull
                         @NotNull CharSequence s,
                         int start,
                         int length)
                  throws BufferOverflowException,
                         IllegalArgumentException,
                         IndexOutOfBoundsException

Throws:: BufferOverflowException; IllegalArgumentException; IndexOutOfBoundsException

write8bit

@NotNull
default S write8bit(@Nullable
                             @Nullable String s)
                      throws BufferOverflowException

Throws:: BufferOverflowException

write8bit

@NotNull
default S write8bit(@Nullable
                             @Nullable BytesStore bs)
                      throws BufferOverflowException

Throws:: BufferOverflowException

writeByte

@NotNull
S writeByte(byte i8)
              throws BufferOverflowException

Throws:: BufferOverflowException

rawWriteByte

default S rawWriteByte(byte i8)
                throws BufferOverflowException

Throws:: BufferOverflowException

writeUnsignedByte

@NotNull
default S writeUnsignedByte(int i)
                              throws BufferOverflowException,
                                     IllegalArgumentException

Throws:: BufferOverflowException; IllegalArgumentException

writeChar

@NotNull
default S writeChar(char ch)

writeShort

@NotNull
S writeShort(short i16)
               throws BufferOverflowException

Throws:: BufferOverflowException

writeUnsignedShort

@NotNull
default S writeUnsignedShort(int u16)
                               throws BufferOverflowException,
                                      IllegalArgumentException

Throws:: BufferOverflowException; IllegalArgumentException

writeInt24

@NotNull
default S writeInt24(int i)
                       throws BufferOverflowException

Throws:: BufferOverflowException

writeUnsignedInt24

@NotNull
default S writeUnsignedInt24(int i)
                               throws BufferOverflowException

Throws:: BufferOverflowException

writeInt

@NotNull
S writeInt(int i)
             throws BufferOverflowException

Throws:: BufferOverflowException

rawWriteInt

default S rawWriteInt(int i)
               throws BufferOverflowException

Throws:: BufferOverflowException

writeIntAdv

@NotNull
S writeIntAdv(int i,
                       int advance)
                throws BufferOverflowException

Throws:: BufferOverflowException

writeUnsignedInt

@NotNull
default S writeUnsignedInt(long i)
                             throws BufferOverflowException,
                                    IllegalArgumentException

Throws:: BufferOverflowException; IllegalArgumentException

writeLong

@NotNull
S writeLong(long i64)
              throws BufferOverflowException

Throws:: BufferOverflowException

writeLongAdv

@NotNull
S writeLongAdv(long i64,
                        int advance)
                 throws BufferOverflowException

Throws:: BufferOverflowException

writeFloat

@NotNull
S writeFloat(float f)
               throws BufferOverflowException

Throws:: BufferOverflowException

writeDouble

@NotNull
S writeDouble(double d)
                throws BufferOverflowException

Throws:: BufferOverflowException

writeDoubleAndInt

@NotNull
S writeDoubleAndInt(double d,
                             int i)
                      throws BufferOverflowException

Throws:: BufferOverflowException

write

@NotNull
default S write(@NotNull
                         @NotNull RandomDataInput bytes)

Write all data or fail.

write

default S write(@NotNull
                @NotNull BytesStore bytes)

realCapacity
```
long realCapacity()
```
Returns:

capacity without resize

realWriteRemaining
```
long realWriteRemaining()
```
Returns:

writeRemaining with resize

canWriteDirect

default boolean canWriteDirect(long count)

writeSome

@NotNull
default S writeSome(@NotNull
                             @NotNull Bytes bytes)

write

@NotNull
default S write(@NotNull
                         @NotNull RandomDataInput bytes,
                         long offset,
                         long length)
                  throws BufferOverflowException,
                         BufferUnderflowException

Write all data or fail.

Throws:: BufferOverflowException; BufferUnderflowException

write

@NotNull
default S write(@NotNull
                         @NotNull BytesStore bytes,
                         long offset,
                         long length)
                  throws BufferOverflowException,
                         BufferUnderflowException

Write all data or fail.

Throws:: BufferOverflowException; BufferUnderflowException

write

@NotNull
default S write(@NotNull
                         @NotNull byte[] bytes)
                  throws BufferOverflowException

Throws:: BufferOverflowException

write

@NotNull
S write(byte[] bytes,
                 int offset,
                 int length)
          throws BufferOverflowException

Write all data or fail.

Throws:: BufferOverflowException

writeSome

@NotNull
S writeSome(ByteBuffer buffer)
              throws BufferOverflowException

Throws:: BufferOverflowException

writeBoolean

@NotNull
default S writeBoolean(boolean flag)
                         throws BufferOverflowException

Throws:: BufferOverflowException

writeOrderedInt

@NotNull
S writeOrderedInt(int i)
                    throws BufferOverflowException

Throws:: BufferOverflowException

writeOrderedLong

@NotNull
S writeOrderedLong(long i)
                     throws BufferOverflowException

Throws:: BufferOverflowException

nativeWrite
```
@Deprecated
void nativeWrite(long address,
                             long size)
                      throws BufferOverflowException
```
Deprecated.

This is an expert level method for writing out data to native memory.

Parameters:

address - to write to.

size - in bytes.

Throws:

BufferOverflowException

writeEnum

default <E extends Enum<E>> S writeEnum(@NotNull
                                        E e)
                                 throws BufferOverflowException

Throws:: BufferOverflowException

appendUtf8

@NotNull
default S appendUtf8(@NotNull
                              @NotNull CharSequence cs)
                       throws BufferOverflowException

Throws:: BufferOverflowException

appendUtf8

@NotNull
default S appendUtf8(int codepoint)
                       throws BufferOverflowException

Throws:: BufferOverflowException

appendUtf8

@NotNull
default S appendUtf8(char[] chars,
                              int offset,
                              int length)
                       throws BufferOverflowException,
                              IllegalArgumentException

Throws:: BufferOverflowException; IllegalArgumentException

appendUtf8

@NotNull
default S appendUtf8(@NotNull
                              @NotNull CharSequence cs,
                              int offset,
                              int length)
                       throws BufferOverflowException,
                              IllegalArgumentException

Throws:: BufferOverflowException; IllegalArgumentException

appendUtf8

@NotNull
default S appendUtf8(byte[] bytes,
                              int offset,
                              int length,
                              byte coder)
                       throws BufferOverflowException,
                              IllegalArgumentException

Throws:: BufferOverflowException; IllegalArgumentException

appendUtf8

@NotNull
default S appendUtf8(byte[] bytes,
                              int offset,
                              int length)
                       throws BufferOverflowException,
                              IllegalArgumentException

Throws:: BufferOverflowException; IllegalArgumentException

copyFrom

default void copyFrom(@NotNull
                      @NotNull InputStream input)
               throws IOException,
                      BufferOverflowException,
                      IllegalArgumentException

Throws:: IOException; BufferOverflowException; IllegalArgumentException

writePositionRemaining

default void writePositionRemaining(long position,
                                    long length)

writeHistogram

default void writeHistogram(@NotNull
                            @NotNull net.openhft.chronicle.core.util.Histogram histogram)

writeBigDecimal

default void writeBigDecimal(@NotNull
                             @NotNull BigDecimal bd)

writeBigInteger

default void writeBigInteger(@NotNull
                             @NotNull BigInteger bi)

writeWithLength

default void writeWithLength(RandomDataInput bytes)

start
```
default long start()
```
Returns:

The smallest position allowed in this buffer.

capacity
```
default long capacity()
```
Returns:

the highest limit allowed for this buffer.

readPosition
```
default long readPosition()
```
The read position must be start() <= readPosition() && readPosition() <= readLimit() && readPosition < safeLimit()

Returns:

position to read from.

writePosition
```
default long writePosition()
```
The read position must be readPosition() <= writePosition() && writePosition() <= writeLimit()

Returns:

position to write to.

readRemaining
```
default long readRemaining()
```
Returns:

How many more bytes can we read.

writeRemaining
```
default long writeRemaining()
```
Returns:

How many more bytes can we written.

readLimit
```
default long readLimit()
```
Returns:

the highest offset or position allowed for this buffer.

writeLimit
```
default long writeLimit()
```

addressForRead
```
long addressForRead(long offset)
             throws UnsupportedOperationException,
                    BufferUnderflowException
```
Obtain the underlying addressForRead. This is for expert users only.

Parameters:

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

Returns:

the underlying addressForRead of the buffer

Throws:

UnsupportedOperationException - if the underlying buffer is on the heap

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

addressForRead

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

Throws:: UnsupportedOperationException; BufferUnderflowException

addressForWrite
```
long addressForWrite(long offset)
              throws UnsupportedOperationException,
                     BufferOverflowException
```
Obtain the underlying addressForRead. This is for expert users only.

Parameters:

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

Returns:

the underlying addressForRead of the buffer

Throws:

UnsupportedOperationException - if the underlying buffer is on the heap

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

addressForWritePosition

long addressForWritePosition()
                      throws UnsupportedOperationException,
                             BufferOverflowException

Throws:: UnsupportedOperationException; BufferOverflowException

byteOrder
```
default ByteOrder byteOrder()
```

bytesForRead

@NotNull
@NotNull Bytes bytesForRead()
                              throws IllegalStateException

Returns:: the streaming bytes for reading.
Throws:: IllegalStateException

bytesForWrite

@NotNull
@NotNull Bytes bytesForWrite()
                               throws IllegalStateException

Returns:: the streaming bytes for writing.
Throws:: IllegalStateException

compareAndSwapInt
```
boolean compareAndSwapInt(long offset,
                          int expected,
                          int value)
                   throws BufferOverflowException
```
Perform a 32-bit CAS at a given offset.

Parameters:

offset - to perform CAS

expected - value

value - to set

Returns:

true, if successful.

Throws:

BufferOverflowException

testAndSetInt

void testAndSetInt(long offset,
                   int expected,
                   int value)

compareAndSwapLong

boolean compareAndSwapLong(long offset,
                           long expected,
                           long value)
                    throws BufferOverflowException

Perform a 64-bit CAS at a given offset.

Parameters:: offset - to perform CAS; expected - value; value - to set
Returns:: true, if successful.
Throws:: BufferOverflowException

compareAndSwapFloat

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

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

Parameters:: offset - to perform CAS; expected - value; value - to set
Returns:: true, if successful.
Throws:: BufferOverflowException

compareAndSwapDouble

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

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

Parameters:: offset - to perform CAS; expected - value; value - to set
Returns:: true, if successful.
Throws:: BufferOverflowException

sharedMemory
```
boolean sharedMemory()
```
Returns:

true if these Bytes use shared memory.

isDirectMemory
```
boolean isDirectMemory()
```

Interface StreamingDataOutput<S extends StreamingDataOutput<S>>

Field Summary

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

Method Summary

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

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

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

Field Detail

JAVA9_STRING_CODER_LATIN

JAVA9_STRING_CODER_UTF16

Method Detail

writePosition

writeLimit

writeSkip

alignBy

outputStream

writeStopBit

writeStopBit

writeStopBit

writeStopBitDecimal

writeUtf8

writeUtf8

writeUTFΔ

write8bit

write8bit

write

write

write8bit

write8bit

writeByte

rawWriteByte

writeUnsignedByte

writeChar

writeShort

writeUnsignedShort

writeInt24

writeUnsignedInt24

writeInt

rawWriteInt

writeIntAdv

writeUnsignedInt

writeLong

writeLongAdv

writeFloat

writeDouble

writeDoubleAndInt

write

write

realCapacity

realWriteRemaining

canWriteDirect

writeSome

write

write

write

write

writeSome

writeBoolean

writeOrderedInt

writeOrderedLong

nativeWrite

writeEnum

appendUtf8

appendUtf8

appendUtf8

appendUtf8

appendUtf8

appendUtf8

copyFrom

writePositionRemaining

writeHistogram

writeBigDecimal

writeBigInteger

writeWithLength

start

capacity

readPosition

writePosition

readRemaining

writeRemaining