jdk.util.concurrent.atomic.AtomicReferenceArray — clojure-interop/java.util.concurrent 1.0.0

An array of object references in which elements may be updated atomically. See the java.util.concurrent.atomic package specification for description of the properties of atomic variables.

->atomic-reference-array clj

(->atomic-reference-array length)

Constructor.

Creates a new AtomicReferenceArray of the given length, with all elements initially null.

length - the length of the array - int

accumulate-and-get clj

(accumulate-and-get this i x accumulator-function)

Atomically updates the element at index i with the results of applying the given function to the current and given values, returning the updated value. The function should be side-effect-free, since it may be re-applied when attempted updates fail due to contention among threads. The function is applied with the current value at index i as its first argument, and the given update as the second argument.

i - the index - int x - the update value - AtomicReferenceArray.E accumulator-function - a side-effect-free function of two arguments - java.util.function.BinaryOperator<AtomicReferenceArray.E>

returns: the updated value - AtomicReferenceArray.E

compare-and-set clj

(compare-and-set this i expect update)

Atomically sets the element at position i to the given updated value if the current value == the expected value.

i - the index - int expect - the expected value - AtomicReferenceArray.E update - the new value - AtomicReferenceArray.E

returns: true if successful. False return indicates that the actual value was not equal to the expected value. - boolean

get clj

(get this i)

Gets the current value at position i.

i - the index - int

returns: the current value - AtomicReferenceArray.E

get-and-accumulate clj

(get-and-accumulate this i x accumulator-function)

Atomically updates the element at index i with the results of applying the given function to the current and given values, returning the previous value. The function should be side-effect-free, since it may be re-applied when attempted updates fail due to contention among threads. The function is applied with the current value at index i as its first argument, and the given update as the second argument.

i - the index - int x - the update value - AtomicReferenceArray.E accumulator-function - a side-effect-free function of two arguments - java.util.function.BinaryOperator<AtomicReferenceArray.E>

returns: the previous value - AtomicReferenceArray.E

get-and-set clj

(get-and-set this i new-value)

Atomically sets the element at position i to the given value and returns the old value.

i - the index - int new-value - the new value - AtomicReferenceArray.E

returns: the previous value - AtomicReferenceArray.E

get-and-update clj

(get-and-update this i update-function)

Atomically updates the element at index i with the results of applying the given function, returning the previous value. The function should be side-effect-free, since it may be re-applied when attempted updates fail due to contention among threads.

i - the index - int update-function - a side-effect-free function - java.util.function.UnaryOperator<AtomicReferenceArray.E>

returns: the previous value - AtomicReferenceArray.E

lazy-set clj

(lazy-set this i new-value)

Eventually sets the element at position i to the given value.

i - the index - int new-value - the new value - AtomicReferenceArray.E

length clj

(length this)

Returns the length of the array.

returns: the length of the array - int

set clj

(set this i new-value)

Sets the element at position i to the given value.

i - the index - int new-value - the new value - AtomicReferenceArray.E

to-string clj

(to-string this)

Returns the String representation of the current values of array.

returns: the String representation of the current values of array - java.lang.String

update-and-get clj

(update-and-get this i update-function)

Atomically updates the element at index i with the results of applying the given function, returning the updated value. The function should be side-effect-free, since it may be re-applied when attempted updates fail due to contention among threads.

i - the index - int update-function - a side-effect-free function - java.util.function.UnaryOperator<AtomicReferenceArray.E>

returns: the updated value - AtomicReferenceArray.E

weak-compare-and-set clj

(weak-compare-and-set this i expect update)

Atomically sets the element at position i to the given updated value if the current value == the expected value.

May fail spuriously and does not provide ordering guarantees, so is only rarely an appropriate alternative to compareAndSet.

i - the index - int expect - the expected value - AtomicReferenceArray.E update - the new value - AtomicReferenceArray.E

returns: true if successful - boolean