AtomicReference

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

@ExperimentalAtomicApi
expect class AtomicReference<T>(value: T)

Ссылка на объект, значение которой можно обновлять атомарно.

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

При компиляции для бэкенда Native AtomicReference хранит volatile-переменную типа T и атомарно обновляет её. Дополнительные сведения о гарантиях атомарности чтения и записи см. в документации kotlin.concurrent.Volatile.

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

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

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

@ExperimentalAtomicApi
actual class AtomicReference<T>(value: T)

Ссылка на объект, значение которой можно обновлять атомарно.

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

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

@ExperimentalAtomicApi
actual class AtomicReference<T>(value: T)

Ссылка на объект, значение которой можно обновлять атомарно.

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

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

@ExperimentalAtomicApi
actual class AtomicReference<T>(var value: T)

Ссылка на объект, значение которой можно обновлять атомарно.

Операция чтения load имеет те же эффекты для памяти, что и чтение свойства Volatile; операция записи store имеет те же эффекты для памяти, что и запись свойства Volatile; операции чтения-модификации-записи, такие как exchange, compareAndSet, compareAndExchange, имеют те же эффекты для памяти, что и чтение и запись свойства Volatile.

Дополнительные сведения о гарантиях атомарности чтения и записи см. в документации kotlin.concurrent.Volatile.

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

@ExperimentalAtomicApi
actual class AtomicReference<T>(value: T)

Ссылка на объект, значение которой можно обновлять атомарно.

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

expect constructor(value: T)

@Volatile
var value: T

@ExperimentalAtomicApi
fun <T> AtomicReference<T>.asJavaAtomic(): AtomicReference<T>

expect fun compareAndExchange(expectedValue: T, newValue: T): T

expect fun compareAndSet(expectedValue: T, newValue: T): Boolean

expect fun exchange(newValue: T): T

actual fun exchange(newValue: T): T

@ExperimentalAtomicApi
expect inline fun <T> AtomicReference<T>.fetchAndUpdate(transform: (T) -> T): T

fun getAndSet(newValue: T): T

expect fun load(): T

expect fun store(newValue: T)

expect open override fun toString(): String

@ExperimentalAtomicApi
expect inline fun <T> AtomicReference<T>.update(transform: (T) -> T)

@ExperimentalAtomicApi
expect inline fun <T> AtomicReference<T>.updateAndFetch(transform: (T) -> T): T