AtomicArray

Требования к платформе и версии: Common (2.1)

@ExperimentalAtomicApi
expect class AtomicArray<T>

Обобщённый массив объектов, элементы которого можно обновлять атомарно.

Особенности реализации для конкретных платформ:

При использовании Native-бэкенда AtomicArray хранит Array с элементами типа T и атомарно обновляет его элементы. Подробнее о гарантиях атомарности при чтении и записи см. в описании kotlin.concurrent.Volatile.

При использовании JVM экземпляры AtomicArray представлены типом java.util.concurrent.atomic.AtomicReferenceArray. Сведения о гарантиях volatile-доступа и обновлений атомарных значений см. в спецификации языка Java (17.4 Модель памяти).

Для JS и Wasm AtomicArray реализован тривиальным образом и не является потокобезопасным, поскольку эти платформы не поддерживают многопоточность.

Требования к платформе и версии: JS (2.1)

@ExperimentalAtomicApi
actual class AtomicArray<T>

Обобщённый массив объектов, элементы которого можно обновлять атомарно.

Поскольку платформа JS не поддерживает многопоточность, реализация тривиальна и не выполняет атомарную синхронизацию.

Требования к платформе и версии: JVM (2.1)

@ExperimentalAtomicApi
actual class AtomicArray<T>

Обобщённый массив объектов, элементы которого можно обновлять атомарно.

Экземпляры AtomicArray представлены типом java.util.concurrent.atomic.AtomicReferenceArray и обеспечивают те же гарантии атомарности.

Требования к платформе и версии: Native (2.1)

@ExperimentalAtomicApi
actual class AtomicArray<T>

Обобщённый массив объектов, элементы которого можно обновлять атомарно.

Операция чтения loadAt имеет те же эффекты на память, что и чтение свойства Volatile; операция записи storeAt имеет те же эффекты на память, что и запись свойства Volatile; операции чтения-модификации-записи, такие как exchangeAt, compareAndSetAt, compareAndExchangeAt, имеют те же эффекты на память, что и чтение и запись свойства Volatile.

Подробнее о гарантиях атомарности при чтении и записи см. в описании kotlin.concurrent.Volatile.

Требования к платформе и версии: Wasm-JS (2.1), Wasm-WASI (2.1)

@ExperimentalAtomicApi
actual class AtomicArray<T>

Обобщённый массив объектов, элементы которого можно обновлять атомарно.

Поскольку платформа Wasm не поддерживает многопоточность, реализация тривиальна и не выполняет атомарную синхронизацию.

expect constructor(array: Array<T>)

actual constructor(array: Array<T>)

val length: Int

expect val size: Int

@ExperimentalAtomicApi
fun <T> AtomicArray<T>.asJavaAtomicArray(): AtomicReferenceArray<T>

fun compareAndExchange(index: Int, expectedValue: T, newValue: T): T

expect fun compareAndExchangeAt(index: Int, expectedValue: T, newValue: T): T

fun compareAndSet(index: Int, expectedValue: T, newValue: T): Boolean

expect fun compareAndSetAt(index: Int, expectedValue: T, newValue: T): Boolean

expect fun exchangeAt(index: Int, newValue: T): T

@ExperimentalAtomicApi
expect inline fun <T> AtomicArray<T>.fetchAndUpdateAt(index: Int, transform: (T) -> T): T

operator fun get(index: Int): T

fun getAndSet(index: Int, newValue: T): T

expect fun loadAt(index: Int): T

operator fun set(index: Int, newValue: T)

expect fun storeAt(index: Int, newValue: T)

expect open override fun toString(): String

@ExperimentalAtomicApi
expect inline fun <T> AtomicArray<T>.updateAndFetchAt(index: Int, transform: (T) -> T): T

@ExperimentalAtomicApi
expect inline fun <T> AtomicArray<T>.updateAt(index: Int, transform: (T) -> T)