Volatile

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

@Target([AnnotationTarget.FIELD]) @DeprecatedSinceKotlin("1.9") annotation class Volatile

Устарело: Вместо этого используйте аннотацию kotlin.concurrent.Volatile в коде для нескольких платформ.

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

@Target([AnnotationTarget.FIELD]) annotation class Volatile

Для JVM

Помечает поле JVM, которое лежит в основе анотированного var свойства как volatile, что означает, что чтение и запись в это поле атомны, и записи всегда видны другим потокам. Если другой поток считывает значение этого поля (например, через его метод доступа), он видит не только это значение, но и все побочные эффекты, которые привели к записи этого значения.

Обратите внимание, что только операции с полем базового уровня атомны, когда поле анотировано Volatile. Например, если метод получения или установки свойства выполняет несколько операций с базовым полем, операция с свойством, то есть чтение или установка через эти методы доступа, не гарантируется, что будет атомарной.

Для Common

Помечает поле JVM, которое лежит в основе анотированного var свойства как volatile, что означает, что чтение и запись в это поле атомны, и записи всегда видны другим потокам. Если другой поток считывает значение этого поля (например, через его метод доступа), он видит не только это значение, но и все побочные эффекты, которые привели к записи этого значения.

Эта аннотация имеет эффект только в Kotlin/JVM. В проектах с несколькими платформами рекомендуется использовать аннотацию kotlin.concurrent.Volatile вместо нее.

Обратите внимание, что только операции с полем базового уровня атомны, когда поле анотировано Volatile. Например, если метод получения или установки свойства выполняет несколько операций с базовым полем, операция с свойством, то есть чтение или установка через эти методы доступа, не гарантируется, что будет атомарной.