compare
Платформы и требования к версии: Common (2.1), JS (2.1), Native (2.1), Wasm-JS (2.1), Wasm-WASI (2.1)
expect fun compareAndExchangeAt(index: Int, expectedValue: T, newValue: T): T
Атомарно записывает новое значение в элемент этого AtomicArray по указанному индексу, если текущее значение равно ожидаемому значению, и в любом случае возвращает старое значение элемента.
Сравнение значений выполняется по ссылке.
Исключения
если индекс выходит за пределы этого массива.
Примеры
import kotlin.concurrent.atomics.*
import kotlin.concurrent.atomics.AtomicArray
import kotlin.test.assertFailsWith
fun main() {
//sampleStart
val a = AtomicArray(arrayOf("aaa", "bbb", "ccc"))
// Current value of a[1] is "bbb, it is equal to the expected value "bbb" ->
// compareAndExchangeAt succeeds, stores the new value "kkk" to a[1] and returns the old value "bbb".
println(a.compareAndExchangeAt(index = 1, expectedValue = "bbb", newValue = "kkk")) // bbb
println(a.loadAt(1)) // kkk
println(a.toString()) // [aaa, kkk, ccc]
// Current value of a[2] is "ccc", it is not equal to the expected value "aaa" ->
// compareAndExchangeAt fails, does not store the new value to a[2] and returns the current value "ccc".
println(a.compareAndExchangeAt(index = 2, expectedValue = "aaa", newValue = "jjj")) // ccc
println(a.loadAt(2)) // ccc
println(a.toString()) // [aaa, kkk, ccc]
//sampleEnd
}Платформы и требования к версии: JVM (2.1)
actual fun compareAndExchangeAt(index: Int, expectedValue: T, newValue: T): T
Атомарно записывает новое значение в элемент этого AtomicArray по указанному индексу, если текущее значение равно ожидаемому значению, и в любом случае возвращает старое значение элемента.
Сравнение значений выполняется по ссылке.
Для обеспечения совместимости с Java 8 метод compareAndExchangeAt реализован с использованием java.util.concurrent.atomic.AtomicReferenceArray.compareAndSet, поскольку метод java.util.concurrent.atomic.AtomicReferenceArray.compareAndExchange доступен только начиная с Java 9.
В будущих выпусках планируется делегировать реализацию compareAndExchangeAt методу java.util.concurrent.atomic.AtomicReferenceArray.compareAndExchange для пользователей, работающих с JDK 9 или более поздней версии.
Исключения
если индекс выходит за пределы этого массива.
Примеры
import kotlin.concurrent.atomics.*
import kotlin.concurrent.atomics.AtomicArray
import kotlin.test.assertFailsWith
fun main() {
//sampleStart
val a = AtomicArray(arrayOf("aaa", "bbb", "ccc"))
// Current value of a[1] is "bbb, it is equal to the expected value "bbb" ->
// compareAndExchangeAt succeeds, stores the new value "kkk" to a[1] and returns the old value "bbb".
println(a.compareAndExchangeAt(index = 1, expectedValue = "bbb", newValue = "kkk")) // bbb
println(a.loadAt(1)) // kkk
println(a.toString()) // [aaa, kkk, ccc]
// Current value of a[2] is "ccc", it is not equal to the expected value "aaa" ->
// compareAndExchangeAt fails, does not store the new value to a[2] and returns the current value "ccc".
println(a.compareAndExchangeAt(index = 2, expectedValue = "aaa", newValue = "jjj")) // ccc
println(a.loadAt(2)) // ccc
println(a.toString()) // [aaa, kkk, ccc]
//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-array/compare-and-exchange-at.html
