Package 

Class AtomicFastByteArray64

  • All Implemented Interfaces:
    io.github.millibyte1.array64.Array64 , io.github.millibyte1.array64.ByteArray64 , io.github.millibyte1.array64.atomic.AtomicArray64 , kotlin.collections.Iterable 
    
public final class AtomicFastByteArray64
extends FastByteArray64 implements AtomicArray64<Byte>

    An extension of the FastByteArray64 class supporting atomic operations such as compareAndSet. Loosely based off the Jetbrains JDK implementation of AtomicReferenceArray.

    • Constructor Detail

      • AtomicFastByteArray64

        AtomicFastByteArray64(Long size)
        Creates a new array of the specified size, with all elements initialized to zero.

      • AtomicFastByteArray64

        AtomicFastByteArray64(Long size, Function1<Long, Byte> init)
        Creates a new array of the specified size, with all elements initialized according to the given init function.

      • AtomicFastByteArray64

        AtomicFastByteArray64(FastByteArray64 array)
        Creates a copy of the given array.
        Parameters:
        array - the array in question

      • AtomicFastByteArray64

        AtomicFastByteArray64(Array<ByteArray> array, Boolean copy)
        Creates a new array from the given FastUtil BigArray, either by copying its contents or simply wrapping it.
        Parameters:
        array - the array in question
        copy - whether to copy (true) the array or directly use it as the internal array (false)

      • AtomicFastByteArray64

        AtomicFastByteArray64(Array<ByteArray> array)
        Creates a new array from the given FastUtil BigArray, either by copying its contents or simply wrapping it.
        Parameters:
        array - the array in question

    • Method Detail

      • size

         Long size()

        The number of elements in this array.

      • get

         Byte get(Long index)

        Returns the element at the given index. This method can be called using the index operator.

        Parameters:
        index - the index of the desired element

      • set

         Unit set(Long index, Byte value)

        Sets the element at the given index to the given value. This method can be called using the index operator.

        Parameters:
        index - the index of the element to set
        value - the value to set the element to

      • getAndSet

         Byte getAndSet(Long index, Byte new)

        Sets the element at position index to the given new value and returns the old value. Atomic.

        Parameters:
        index - the index of the element to set
        new - the value to set the element to

      • getAndSet

         Byte getAndSet(Long index, Function1<Byte, Byte> transform)

        Sets the element at position index to the value resulting from applying the given transform to the old value. Atomic.

        Parameters:
        index - the index of the element to set
        transform - the pure (side effect-free) transform function to apply to the old value

      • setAndGet

         Byte setAndGet(Long index, Function1<Byte, Byte> transform)

        Sets the element at position index to the resulting value from applying the given transform to the old value. Atomic.

        Parameters:
        index - the index of the element to set
        transform - the pure (side effect-free) transform function to apply to the old value

      • compareAndSet

         Boolean compareAndSet(Long index, Byte new, Byte expected)

        Sets the element at position index to the given new value if the current value matches expected. Atomic.

        Parameters:
        index - the index of the element to try and set
        new - the value to set the element to
        expected - the expected value of the element

      • compareAndSet

         Boolean compareAndSet(Long index, Byte new, Function2<Byte, Byte, Boolean> predicate)

        Sets the element at position index to the given new value if the provided predicate returns true when applied to the old and new values.

        Parameters:
        index - the index of the element to try and set
        new - the value to set the element to
        predicate - the binary predicate to apply to the old and new values to decide whether to update

      • lazySet

         Unit lazySet(Long index, Byte value)

        Eventually sets the element at the given index to the given value. Depending on the implementation, may immediately perform a volatile write.

        Parameters:
        index - the index of the element to set
        value - the value to set the element to