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