8.32 ATOMIC_FETCH_ADD — Атомарная операция ADD с предварительным считыванием

Описание:

ATOMIC_FETCH_ADD(ATOM, VALUE, OLD) атомарно сохраняет значение ATOM в OLD и добавляет значение VALUE к переменной ATOM. Если STAT присутствует и вызов был успешным, ему присваивается значение 0. Если он присутствует и вызов завершился неудачей, ему присваивается положительное значение; в частности, для коиндексированной ATOM, если удалённый образ остановился, ему присваивается значение ISO_FORTRAN_ENV’s STAT_STOPPED_IMAGE, а если удалённый образ потерпел неудачу, значение STAT_FAILED_IMAGE.

Стандарт:

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

Класс:

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

Синтаксис:

CALL ATOMIC_FETCH_ADD (ATOM, VALUE, old [, STAT])

Аргументы:

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

Пример:

program atomic
  use iso_fortran_env
  integer(atomic_int_kind) :: atom[*], old
  call atomic_add (atom[1], this_image(), old)
end program atomic

См. также:

ATOMIC_DEFINE — Установка переменной атомарно, ATOMIC_ADD — Атомарная операция ADD, ISO_FORTRAN_ENV, ATOMIC_FETCH_AND — Атомарная побитовая операция AND с предварительным считыванием, ATOMIC_FETCH_OR — Атомарная побитовая операция OR с предварительным считыванием, ATOMIC_FETCH_XOR — Атомарная побитовая операция XOR с предварительным считыванием

© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-14.2.0/gfortran/ATOMIC_005fFETCH_005fADD.html