net.openhft.chronicle.bytes.ref

Class BinaryBooleanReference

java.lang.Object

net.openhft.chronicle.core.io.AbstractCloseable

net.openhft.chronicle.bytes.ref.AbstractReference

net.openhft.chronicle.bytes.ref.BinaryBooleanReference

All Implemented Interfaces:

Closeable, AutoCloseable, Byteable, net.openhft.chronicle.core.io.ManagedCloseable, net.openhft.chronicle.core.io.Monitorable, net.openhft.chronicle.core.io.QueryCloseable, net.openhft.chronicle.core.io.ReferenceOwner, net.openhft.chronicle.core.io.SingleThreadedChecked, net.openhft.chronicle.core.values.BooleanValue

public class BinaryBooleanReference
extends AbstractReference
implements net.openhft.chronicle.core.values.BooleanValue

Stores a boolean as a single byte.

The encoding uses 0xB0 for false and 0xB1 for true to avoid confusion with ASCII digits.

Any other byte value yields undefined behaviour in getValue().

See Also:

BytesStore, BooleanValue

Field Summary

Fields inherited from class net.openhft.chronicle.bytes.ref.AbstractReference

bytesStore, offset

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

closedHere, DISABLE_DISCARD_WARNING, WARN_NS

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

INIT, TMP

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

DISABLE_SINGLE_THREADED_CHECK

Constructor Summary

Constructors

Constructor and Description
BinaryBooleanReference()

Method Summary

Modifier and Type	Method and Description
void	bytesStore(@NotNull BytesStore bytes, long offset, long length) Sets the underlying BytesStore to work with, along with the offset and length.
boolean	getValue() Reads a boolean value from the bytes store.
long	maxSize() Returns the maximum size of the byte representation of a boolean value.
void	setValue(boolean flag) Writes a boolean value to the bytes store.

Methods inherited from class net.openhft.chronicle.bytes.ref.AbstractReference

acceptNewBytesStore, address, bytesStore, lock, offset, performClose, tryLock, unmonitor

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

assertCloseable, assertCloseablesClosed, close, createdHere, disableCloseableTracing, enableCloseableTracing, gcAndWaitForCloseablesToClose, isClosed, isClosing, isInUserThread, referenceId, shouldPerformCloseInBackground, shouldWaitForClosed, singleThreadedCheckDisabled, singleThreadedCheckDisabled, singleThreadedCheckReset, threadSafetyCheck, throwExceptionIfClosed, throwExceptionIfClosedInSetter, toString, waitForCloseablesToClose, waitForClosed, warnAndCloseIfNotClosed

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

close, closeQuietly, closeQuietly

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

isClosed, isClosing

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

referenceName, temporary

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

unmonitor

Constructor Detail

BinaryBooleanReference

public BinaryBooleanReference()

Method Detail

bytesStore

public void bytesStore(@NotNull
                       @NotNull BytesStore bytes,
                       long offset,
                       long length)
                throws IllegalStateException,
                       IllegalArgumentException,
                       BufferOverflowException

Sets the underlying BytesStore to work with, along with the offset and length.

Specified by:

bytesStore in interface Byteable

Overrides:

bytesStore in class AbstractReference

Parameters:

bytes - the BytesStore to set

offset - the offset to set

length - the length to set

Throws:

IllegalArgumentException - If the arguments are invalid

BufferOverflowException - If the provided buffer is too small

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

maxSize

public long maxSize()

Returns the maximum size of the byte representation of a boolean value.

Specified by:

maxSize in interface Byteable

Returns:

The maximum size of a boolean in bytes

getValue

public boolean getValue()
                 throws IllegalStateException,
                        BufferUnderflowException

Reads a boolean value from the bytes store. Behaviour is undefined if the stored byte is neither

Specified by:

getValue in interface net.openhft.chronicle.core.values.BooleanValue

Returns:

The read boolean value

Throws:

BufferUnderflowException - If the bytes store contains insufficient data

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 0xB0 nor 0xB1.

IllegalStateException

setValue

public void setValue(boolean flag)
              throws IllegalStateException

Writes a boolean value to the bytes store.

Specified by:

setValue in interface net.openhft.chronicle.core.values.BooleanValue

Parameters:

flag - The boolean value to write

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