fetchAndAddAt

kotlin-stdlib/kotlin.concurrent.atomics/AtomicLongArray/fetchAndAddAt

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

expect fun fetchAndAddAt(index: Int, delta: Long): Long

Атомарно добавляет заданное приращение к элементу этого AtomicLongArray по заданному индексу и возвращает прежнее значение элемента.

Выбрасывает исключение

IndexOutOfBoundsException

если индекс выходит за пределы этого массива.

Примеры

import kotlin.concurrent.atomics.*
import kotlin.concurrent.atomics.AtomicArray
import kotlin.test.assertFailsWith

fun main() { 
   //sampleStart 
   val a = AtomicLongArray(longArrayOf(1, 2, 3))
// Returns the old value before the addition.
println(a.fetchAndAddAt(1, 10)) // 2
println(a.loadAt(1)) // 12
println(a.toString()) // [1, 12, 3] 
   //sampleEnd
}

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

actual fun fetchAndAddAt(index: Int, delta: Long): Long

Имеет те же эффекты для памяти, что и java.util.concurrent.atomic.AtomicLongArray.getAndAdd.

Выбрасывает исключение

IndexOutOfBoundsException

если индекс выходит за пределы этого массива.

Примеры

import kotlin.concurrent.atomics.*
import kotlin.concurrent.atomics.AtomicArray
import kotlin.test.assertFailsWith

fun main() { 
   //sampleStart 
   val a = AtomicLongArray(longArrayOf(1, 2, 3))
// Returns the old value before the addition.
println(a.fetchAndAddAt(1, 10)) // 2
println(a.loadAt(1)) // 12
println(a.toString()) // [1, 12, 3] 
   //sampleEnd
}

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

actual fun fetchAndAddAt(index: Int, delta: Long): Long

Выбрасывает исключение

IndexOutOfBoundsException

если индекс выходит за пределы этого массива.

Примеры

import kotlin.concurrent.atomics.*
import kotlin.concurrent.atomics.AtomicArray
import kotlin.test.assertFailsWith

fun main() { 
   //sampleStart 
   val a = AtomicLongArray(longArrayOf(1, 2, 3))
// Returns the old value before the addition.
println(a.fetchAndAddAt(1, 10)) // 2
println(a.loadAt(1)) // 12
println(a.toString()) // [1, 12, 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/fetch-and-add-at.html