compareAndExchange

kotlin-stdlib/kotlin.concurrent.atomics/AtomicInt/compareAndExchange

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

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

Атомарно записывает указанное новое значение в этот объект AtomicInt, если текущее значение равно ожидаемому значению, и в любом случае возвращает старое значение.

Сравнение значений выполняется по значению.

Примеры

import kotlin.concurrent.atomics.*
import kotlin.concurrent.thread

fun main() { 
   //sampleStart 
   val a = AtomicInt(7)
// Current value 7 is equal to the expected value 7 ->
// compareAndExchange succeeds, stores the new value 10 and returns the old value 7.
println(a.compareAndExchange(7, 10)) // 7
println(a.load()) // 10

// Current value 10 is not equal to the expected value 2 ->
// compareAndExchange fails, does not store the new value and returns the current value 10.
println(a.compareAndExchange(2, 12)) // 10
println(a.load()) // 10 
   //sampleEnd
}

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

actual fun compareAndExchange(expectedValue: Int, newValue: Int): Int

Сравнение значений выполняется по значению.

Примеры

import kotlin.concurrent.atomics.*
import kotlin.concurrent.thread

fun main() { 
   //sampleStart 
   val a = AtomicInt(7)
// Current value 7 is equal to the expected value 7 ->
// compareAndExchange succeeds, stores the new value 10 and returns the old value 7.
println(a.compareAndExchange(7, 10)) // 7
println(a.load()) // 10

// Current value 10 is not equal to the expected value 2 ->
// compareAndExchange fails, does not store the new value and returns the current value 10.
println(a.compareAndExchange(2, 12)) // 10
println(a.load()) // 10 
   //sampleEnd
}

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

actual fun compareAndExchange(expectedValue: Int, newValue: Int): Int

Сравнение значений выполняется по значению.

Для обеспечения совместимости с Java 8 метод compareAndExchange реализован с использованием java.util.concurrent.atomic.AtomicInteger.compareAndSet, поскольку метод java.util.concurrent.atomic.AtomicInteger.compareAndExchange доступен только начиная с Java 9.

В будущих версиях планируется делегировать реализацию compareAndExchange методу java.util.concurrent.atomic.AtomicInteger.compareAndExchange для пользователей, использующих JDK 9 или выше.

Примеры

import kotlin.concurrent.atomics.*
import kotlin.concurrent.thread

fun main() { 
   //sampleStart 
   val a = AtomicInt(7)
// Current value 7 is equal to the expected value 7 ->
// compareAndExchange succeeds, stores the new value 10 and returns the old value 7.
println(a.compareAndExchange(7, 10)) // 7
println(a.load()) // 10

// Current value 10 is not equal to the expected value 2 ->
// compareAndExchange fails, does not store the new value and returns the current value 10.
println(a.compareAndExchange(2, 12)) // 10
println(a.load()) // 10 
   //sampleEnd
}

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.concurrent.atomics/-atomic-int/compare-and-exchange.html