Introduce experimental kotlin.concurrent.Volatile annotation KT-55268, KT-55609

Use this annotation in tests to ensure it works the same at least on JVM
This commit is contained in:
Ilya Gorbunov
2022-12-21 22:43:20 +01:00
parent 58d6d7b9ad
commit e2d96da396
10 changed files with 176 additions and 9 deletions
@@ -122,8 +122,16 @@ public expect annotation class JvmInline()
public expect annotation class JvmRecord()
/**
* Marks the JVM backing field of the annotated property as `volatile`, meaning that writes to this field
* are immediately made visible to other threads.
* Marks the JVM backing field of the annotated `var` property as `volatile`, meaning that reads and writes to this field
* are atomic and writes are always made visible to other threads. If another thread reads the value of this field (e.g. through its accessor),
* it sees not only that value, but all side effects that led to writing that value.
*
* This annotation has effect only in Kotlin/JVM. It's recommended to use [kotlin.concurrent.Volatile] annotation instead
* in multiplatform projects.
*
* Note that only _backing field_ operations are atomic when the field is annotated with `Volatile`.
* For example, if the property getter or setter make several operations with the backing field,
* a _property_ operation, i.e. reading or setting it through these accessors, is not guaranteed to be atomic.
*/
@Target(FIELD)
@MustBeDocumented