9.26 ATOMIC_CAS — Атомарное сравнение и обмен

Описание:

ATOMIC_CAS сравнивает переменную ATOM со значением COMPARE; если значение совпадает, ATOM устанавливается в значение NEW. Кроме того, OLD устанавливается в значение ATOM, которое использовалось для сравнения. Если присутствует STAT и вызов был успешным, ему присваивается значение 0. Если он присутствует и вызов не удался, ему присваивается положительное значение; в частности, для коиндексированной ATOM, если удалённое изображение остановилось, ему присваивается значение ISO_FORTRAN_ENV's STAT_STOPPED_IMAGE и если удалённое изображение потерпело неудачу, значение STAT_FAILED_IMAGE.

Стандарт:

TS 18508 или более поздняя версия

Класс:

Атомарная подпрограмма

Синтаксис:

CALL ATOMIC_CAS (ATOM, OLD, COMPARE, NEW [, STAT])

Аргументы:

ATOM	Скалярная комассивная или коиндексированная переменная целого типа с ATOMIC_INT_KIND видом или логического типа с ATOMIC_LOGICAL_KIND видом.
OLD	Скаляр того же типа и вида, что и ATOM.
COMPARE	Скалярная переменная того же типа и вида, что и ATOM.
NEW	Скалярная переменная того же типа, что и ATOM. Если вид отличается, значение преобразуется к виду ATOM.
STAT	(необязательно) Скалярная целочисленная переменная стандартного вида.

Пример:

program atomic
  use iso_fortran_env
  logical(atomic_logical_kind) :: atom[*], prev
  call atomic_cas (atom[1], prev, .false., .true.))
end program atomic

См. также:

ATOMIC_DEFINE, ATOMIC_REF, ISO_FORTRAN_ENV