Класс AtomicIntegerArray

public class AtomicIntegerArray
extends Object
implements Serializable

Конструкторы

AtomicIntegerArray

public AtomicIntegerArray(int length)

Создаёт новый AtomicIntegerArray заданной длины, все элементы которого изначально равны нулю.

Параметры:

length - длина массива

AtomicIntegerArray

public AtomicIntegerArray(int[] array)

Создаёт новый AtomicIntegerArray с такой же длиной, как и заданный массив, и со всеми элементами, скопированными из этого массива.

Параметры:

array - массив для копирования элементов

Исключения:

NullPointerException - если массив равен null

Методы

length

public final int length()

Возвращает длину массива.

Возвращает:

длину массива

get

public final int get(int i)

Возвращает текущее значение в позиции i.

Параметры:

i - индекс

Возвращает:

текущее значение

set

public final void set(int i,
                      int newValue)

Устанавливает элемент в позиции i на заданное значение.

Параметры:

i - индекс

newValue - новое значение

lazySet

public final void lazySet(int i,
                          int newValue)

В конечном итоге устанавливает элемент в позиции i на заданное значение.

Параметры:

i - индекс

newValue - новое значение

С тех пор:

1.6

getAndSet

public final int getAndSet(int i,
                           int newValue)

Атомарно устанавливает элемент в позиции i на заданное значение и возвращает старое значение.

Параметры:

i - индекс

newValue - новое значение

Возвращает:

предыдущее значение

compareAndSet

public final boolean compareAndSet(int i,
                                   int expect,
                                   int update)

Атомарно устанавливает элемент в позиции i на заданное обновлённое значение, если текущее значение == ожидаемое значение.

Параметры:

i - индекс

expect - ожидаемое значение

update - новое значение

Возвращает:

true в случае успеха. Возвращение False указывает, что фактическое значение не было равно ожидаемому значению.

weakCompareAndSet

public final boolean weakCompareAndSet(int i,
                                       int expect,
                                       int update)

Параметры:

i - индекс

expect - ожидаемое значение

update - новое значение

Возвращает:

true в случае успеха

getAndIncrement

public final int getAndIncrement(int i)

Атомарно увеличивает на единицу элемент по индексу i.

Параметры:

i - индекс

Возвращает:

предыдущее значение

getAndDecrement

public final int getAndDecrement(int i)

Атомарно уменьшает на единицу элемент по индексу i.

Параметры:

i - индекс

Возвращает:

предыдущее значение

getAndAdd

public final int getAndAdd(int i,
                           int delta)

Атомарно добавляет заданное значение к элементу по индексу i.

Параметры:

i - индекс

delta - значение для добавления

Возвращает:

предыдущее значение

incrementAndGet

public final int incrementAndGet(int i)

Атомарно увеличивает на единицу элемент по индексу i.

Параметры:

i - индекс

Возвращает:

обновлённое значение

decrementAndGet

public final int decrementAndGet(int i)

Атомарно уменьшает на единицу элемент по индексу i.

Параметры:

i - индекс

Возвращает:

обновлённое значение

addAndGet

public final int addAndGet(int i,
                           int delta)

Атомарно добавляет заданное значение к элементу по индексу i.

Параметры:

i - индекс

delta - значение для добавления

Возвращает:

обновлённое значение

getAndUpdate

public final int getAndUpdate(int i,
                              IntUnaryOperator updateFunction)

Атомарно обновляет элемент по индексу i результатом применения заданной функции, возвращая предыдущее значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда попытки обновления терпят неудачу из-за конкуренции между потоками.

Параметры:

i - индекс

updateFunction - функция без побочных эффектов

Возвращает:

предыдущее значение

С тех пор:

1.8

updateAndGet

public final int updateAndGet(int i,
                              IntUnaryOperator updateFunction)

Атомарно обновляет элемент по индексу i результатом применения заданной функции, возвращая обновлённое значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда попытки обновления терпят неудачу из-за конкуренции между потоками.

Параметры:

i - индекс

updateFunction - функция без побочных эффектов

Возвращает:

обновлённое значение

С тех пор:

1.8

getAndAccumulate

public final int getAndAccumulate(int i,
                                  int x,
                                  IntBinaryOperator accumulatorFunction)

Атомарно обновляет элемент по индексу i результатом применения заданной функции к текущему и заданным значениям, возвращая предыдущее значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда попытки обновления терпят неудачу из-за конкуренции между потоками. Функция применяется с текущим значением по индексу i в качестве первого аргумента и заданным обновлением в качестве второго аргумента.

Параметры:

i - индекс

x - значение обновления

accumulatorFunction - функция без побочных эффектов от двух аргументов

Возвращает:

предыдущее значение

С тех пор:

1.8

accumulateAndGet

public final int accumulateAndGet(int i,
                                  int x,
                                  IntBinaryOperator accumulatorFunction)

Атомарно обновляет элемент по индексу i результатом применения заданной функции к текущему и заданным значениям, возвращая обновлённое значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда попытки обновления терпят неудачу из-за конкуренции между потоками. Функция применяется с текущим значением по индексу i в качестве первого аргумента и заданным обновлением в качестве второго аргумента.

Параметры:

i - индекс

x - значение обновления

accumulatorFunction - функция без побочных эффектов от двух аргументов

Возвращает:

обновлённое значение

С тех пор:

1.8

toString

public String toString()

Возвращает строковое представление текущих значений массива.

Переопределяет:

toString в классе Object

Возвращает:

строковое представление текущих значений массива