net.openhft.chronicle.core.values

Interface LongArrayValues

All Superinterfaces:

AutoCloseable, Closeable, QueryCloseable

public interface LongArrayValues
extends Closeable

This interface represents a reference to an array of long values. It provides methods to get, set, and manipulate the values. Implementations of this interface are expected to handle the storage and retrieval of the long array.

Implementations may store the array in different formats or mediums. For example, the array could be stored in binary format or text format, in memory or on disk.

The getValueAt and getVolatileValueAt methods retrieve the long value at a specified index. The difference between these methods is that getVolatileValueAt uses volatile semantics, meaning it includes a memory barrier which ensures that subsequent reads and writes are not reordered beyond this point.

The setValueAt and setOrderedValueAt methods set the long value at a specified index. The difference between these methods is that setOrderedValueAt uses ordered semantics, meaning it includes a memory barrier which ensures that previous writes are not reordered beyond this point.

The compareAndSet method atomically sets the value at a specified index to the given updated value if the current value equals the expected value.

The bindValueAt method binds a LongValue to a specified index in the array.

Since:

10/10/13

See Also:

BooleanValue, ByteValue, CharValue, DoubleValue, FloatValue, IntValue, LongValue, ShortValue, StringValue, LongArrayValues, IntArrayValues

Method Summary

Modifier and Type	Method and Description
void	bindValueAt(long index, LongValue value) Binds a LongValue to a specified index in the array.
boolean	compareAndSet(long index, long expected, long value) Atomically sets the value at a specified index to the given updated value if the current value equals the expected value.
long	getCapacity() Retrieves the capacity of the array.
long	getUsed() Retrieves the number of used elements in the array.
long	getValueAt(long index) Retrieves the long value at a specified index.
long	getVolatileValueAt(long index) Retrieves the long value at a specified index using volatile semantics.
boolean	isNull() Checks if the array is null.
void	reset() Resets the array, clearing all values.
void	setMaxUsed(long usedAtLeast) Sets the maximum number of used elements in the array.
void	setOrderedValueAt(long index, long value) Sets the long value at a specified index using ordered semantics.
void	setUsed(long used) Sets the number of used elements in the array.
void	setValueAt(long index, long value) Sets the long value at a specified index.
long	sizeInBytes(long capacity) Calculates the size in bytes of an array with the specified capacity.

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

Method Detail

getCapacity

long getCapacity()
          throws IllegalStateException

Retrieves the capacity of the array.

Returns:

the capacity of the array

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalStateException

getUsed

long getUsed()
      throws IllegalStateException,
             BufferUnderflowException

Retrieves the number of used elements in the array.

Returns:

the number of used elements in the array

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

BufferUnderflowException - If the array is empty

IllegalStateException

setUsed

void setUsed(long used)
      throws IllegalStateException,
             BufferUnderflowException

Sets the number of used elements in the array.

Parameters:

used - the number of used elements in the array

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

BufferUnderflowException - If the array is empty

IllegalStateException

setMaxUsed

void setMaxUsed(long usedAtLeast)
         throws IllegalStateException,
                BufferUnderflowException

Sets the maximum number of used elements in the array.

Parameters:

usedAtLeast - the minimum number of used elements in the array

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

BufferUnderflowException - If the array is empty

IllegalStateException

getValueAt

long getValueAt(long index)
         throws IllegalStateException,
                BufferUnderflowException

Retrieves the long value at a specified index.

Parameters:

index - the index of the long value to retrieve

Returns:

the long value at the specified index

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

BufferUnderflowException - If the index is out of bounds

IllegalStateException

setValueAt

void setValueAt(long index,
                long value)
         throws IllegalStateException,
                BufferOverflowException

Sets the long value at a specified index.

Parameters:

index - the index at which to set the long value

value - the long value to set

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

BufferOverflowException - If the index is out of bounds

IllegalStateException

getVolatileValueAt

long getVolatileValueAt(long index)
                 throws IllegalStateException,
                        BufferUnderflowException

Retrieves the long value at a specified index using volatile semantics.

Parameters:

index - the index of the long value to retrieve

Returns:

the long value at the specified index

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

BufferUnderflowException - If the index is out of bounds

IllegalStateException

setOrderedValueAt

void setOrderedValueAt(long index,
                       long value)
                throws IllegalStateException,
                       BufferOverflowException

Sets the long value at a specified index using ordered semantics.

Parameters:

index - the index at which to set the long value

value - the long value to set

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

BufferOverflowException - If the index is out of bounds

IllegalStateException

compareAndSet

boolean compareAndSet(long index,
                      long expected,
                      long value)
               throws IllegalStateException,
                      BufferOverflowException

Atomically sets the value at a specified index to the given updated value if the current value equals the expected value.

Parameters:

index - the index at which to set the long value

expected - the expected current value

value - the new value

Returns:

true if successful, false otherwise

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

BufferOverflowException - If the index is out of bounds

IllegalStateException

bindValueAt

void bindValueAt(long index,
                 LongValue value)
          throws IllegalStateException,
                 BufferOverflowException

Binds a LongValue to a specified index in the array.

Parameters:

index - the index at which to bind the LongValue

value - the LongValue to bind

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

BufferOverflowException - If the index is out of bounds

IllegalStateException

sizeInBytes

long sizeInBytes(long capacity)
          throws IllegalStateException

Calculates the size in bytes of an array with the specified capacity.

Parameters:

capacity - the capacity of the array

Returns:

the size in bytes of the array

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalStateException

isNull

boolean isNull()
        throws IllegalStateException

Checks if the array is null.

Returns:

true if the array is null, false otherwise

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalStateException

reset

void reset()
    throws IllegalStateException

Resets the array, clearing all values.

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalStateException