compareAndSet

kotlin-stdlib/kotlin.concurrent.atomics/AtomicReference/compareAndSet

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

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

Атомарно сохраняет указанное новое значение в этом объекте AtomicReference, если текущее значение равно ожидаемому значению. Возвращает true, если операция выполнена успешно, и false только в том случае, если текущее значение не равно ожидаемому.

Эта операция обладает так называемой сильной семантикой: она возвращает false тогда и только тогда, когда текущее и ожидаемое значения не равны.

Значения сравниваются по ссылке.

Примеры

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

fun main() { 
   //sampleStart 
   val a = AtomicReference("aaa")
// Current value "aaa" is equal to the expected value "aaa" -> compareAndSet succeeds.
println(a.compareAndSet("aaa", "bbb")) // true
println(a.load()) // bbb

// Current value "bbb" is not equal to the expected value "aaa" -> compareAndSet fails.
println(a.compareAndSet("aaa", "kkk")) // false
println(a.load()) // bbb 
   //sampleEnd
}

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

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

Значения сравниваются по ссылке.

Примеры

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

fun main() { 
   //sampleStart 
   val a = AtomicReference("aaa")
// Current value "aaa" is equal to the expected value "aaa" -> compareAndSet succeeds.
println(a.compareAndSet("aaa", "bbb")) // true
println(a.load()) // bbb

// Current value "bbb" is not equal to the expected value "aaa" -> compareAndSet fails.
println(a.compareAndSet("aaa", "kkk")) // false
println(a.load()) // bbb 
   //sampleEnd
}

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

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

Значения сравниваются по ссылке.

Имеет те же эффекты памяти, что и java.util.concurrent.atomic.AtomicReference.compareAndSet.

Примеры

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

fun main() { 
   //sampleStart 
   val a = AtomicReference("aaa")
// Current value "aaa" is equal to the expected value "aaa" -> compareAndSet succeeds.
println(a.compareAndSet("aaa", "bbb")) // true
println(a.load()) // bbb

// Current value "bbb" is not equal to the expected value "aaa" -> compareAndSet fails.
println(a.compareAndSet("aaa", "kkk")) // false
println(a.load()) // bbb 
   //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-reference/compare-and-set.html