kotlin-stdlib/kotlin.concurrent.atomics/AtomicLong

AtomicLong

A Long value that may be updated atomically.

Platform-specific implementation details:

When targeting the Native backend, AtomicLong stores a volatile Long variable and atomically updates it. For additional details about atomicity guarantees for reads and writes see kotlin.concurrent.Volatile.

When targeting the JVM, instances of AtomicLong are represented by java.util.concurrent.atomic.AtomicLong. For details about guarantees of volatile accesses and updates of atomics refer to The Java Language Specification (17.4 Memory Model).

For JS and Wasm AtomicLong is implemented trivially and is not thread-safe since these platforms do not support multi-threading.

Since Kotlin

2.1

@ExperimentalAtomicApi

actual class AtomicLong(source)

A Long value that may be updated atomically.

Since the JS platform does not support multi-threading, the implementation is trivial and has no atomic synchronizations.

Since Kotlin

2.1

@ExperimentalAtomicApi

actual class AtomicLong(source)

A Long value that may be updated atomically.

Instances of AtomicLong are represented by java.util.concurrent.atomic.AtomicLong and provide the the same atomicity guarantees.

Since Kotlin

2.1

@ExperimentalAtomicApi

actual class AtomicLong(source)

A Long value that may be updated atomically.

Read operation load has the same memory effects as reading a Volatile property; Write operation store has the same memory effects as writing a Volatile property; Read-modify-write operations, like exchange, compareAndSet, compareAndExchange, fetchAndAdd, addAndFetch, have the same memory effects as reading and writing a Volatile property.

For additional details about atomicity guarantees for reads and writes see kotlin.concurrent.Volatile.

Since Kotlin

2.1

@ExperimentalAtomicApi

actual class AtomicLong(source)

A Long value that may be updated atomically.

Since the Wasm platform does not support multi-threading, the implementation is trivial and has no atomic synchronizations.

Since Kotlin

2.1

@ExperimentalAtomicApi

actual class AtomicLong(source)

A Long value that may be updated atomically.

Since the Wasm platform does not support multi-threading, the implementation is trivial and has no atomic synchronizations.

Since Kotlin

2.1

Constructors

AtomicLong

expect constructor(value: Long)

actual constructor(value: Long)

constructor(value: Long)

actual constructor(value: Long)

Properties

value

@Volatile

var value: Long

Since Kotlin 2.1

Functions

addAndFetch

expect fun addAndFetch(delta: Long): Long

Atomically adds the given value to the current value of this AtomicLong and returns the new value.

Since Kotlin 2.1

actual fun addAndFetch(delta: Long): Long

Atomically adds the given value to the current value of this AtomicLong and returns the new value.

Since Kotlin 2.1

actual fun addAndFetch(delta: Long): Long

Atomically adds the given value to the current value of this AtomicLong and returns the new value.

Since Kotlin 2.1

actual fun addAndFetch(delta: Long): Long

Atomically adds the given value to the current value of this AtomicLong and returns the new value.

Since Kotlin 2.1

actual fun addAndFetch(delta: Long): Long

Atomically adds the given value to the current value of this AtomicLong and returns the new value.

Since Kotlin 2.1

actual fun addAndFetch(delta: Long): Long

Atomically adds the given value to the current value of this AtomicLong and returns the new value.

Since Kotlin 2.1

addAndGet

fun ~~addAndGet~~(delta: Long): Long

Atomically adds the given value to the current value and returns the new value.

Since Kotlin 2.1

asJavaAtomic

@ExperimentalAtomicApi

fun AtomicLong.asJavaAtomic(): AtomicLong

Casts the given AtomicLong instance to java.util.concurrent.atomic.AtomicLong.

Since Kotlin 2.1

compareAndExchange

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

Atomically stores the given new value into this AtomicLong if the current value equals the expected value and returns the old value in any case.

Since Kotlin 2.1

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

Atomically stores the given new value into this AtomicLong. if the current value equals the expected value and returns the old value in any case.

Since Kotlin 2.1

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

Atomically stores the given new value into this AtomicLong if the current value equals the expected value and returns the old value in any case.

Since Kotlin 2.1

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

Atomically stores the given new value into this AtomicLong if the current value equals the expected value and returns the old value in any case.

Since Kotlin 2.1

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

Atomically stores the given new value into this AtomicLong if the current value equals the expected value and returns the old value in any case.

Since Kotlin 2.1

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

Atomically stores the given new value into this AtomicLong if the current value equals the expected value and returns the old value in any case.

Since Kotlin 2.1

compareAndSet

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

Atomically stores the given new value into this AtomicLong if the current value equals the expected value, returns true if the operation was successful and false only if the current value was not equal to the expected value.

Since Kotlin 2.1

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

Atomically stores the given new value into this AtomicLong. if the current value equals the expected value, returns true if the operation was successful and false only if the current value was not equal to the expected value.

Since Kotlin 2.1

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

Since Kotlin 2.1

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

Since Kotlin 2.1

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

Since Kotlin 2.1

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

Since Kotlin 2.1

decrementAndFetch

@ExperimentalAtomicApi

fun AtomicLong.decrementAndFetch(): Long