7.2.36 _gfortran_caf_co_reduce — Общая коллективная редукция

Описание:

Вычисляет для каждого элемента массива переменной a значение редукции для этого элемента в текущей команде; если result_image имеет значение 0, результат должен быть сохранен на всех изображениях, в противном случае — только на указанном изображении. opr — чистая функция, выполняющая математически коммутативную и ассоциативную операцию.

opr_flags обозначают следующее; значения складываются по битовым ИЛИ. GFC_CAF_BYREF (1) если результат должен возвращаться по ссылке; GFC_CAF_HIDDENLEN (2) нужно ли указывать длины результата и аргументов в качестве скрытых аргументов; GFC_CAF_ARG_VALUE (4) нужно ли передавать аргументы по значению, GFC_CAF_ARG_DESC (8) нужно ли передавать аргументы по описателю.

Синтаксис:

void _gfortran_caf_co_reduce (gfc_descriptor_t *a, void * (*opr) (void *, void *), int opr_flags, int result_image, int *stat, char *errmsg, int a_len, size_t errmsg_len)

Аргументы:

`a`	intent(inout) Описатель массива с данными для обработки. На целевом изображении(ях) результат перезаписывает старое содержимое.
`opr`	intent(in) Указатель функции на функцию редукции
`opr_flags`	intent(in) Флаги, относящиеся к функции редукции
`result_image`	intent(in) Идентификатор изображения, на которое должно быть скопировано редуцированное значение; если ноль, оно должно быть скопировано на все изображения.
`stat`	intent(out) Содержит статус STAT= и может быть NULL.
`errmsg`	intent(out) При возникновении ошибки это будет установлено на сообщение об ошибке; может быть NULL.
`a_len`	intent(in) длина строки аргумента `a`
`errmsg_len`	intent(in) размер буфера errmsg

ПРИМЕЧАНИЯ

Если result_image не равен нулю, данные в описателе массива a на всех изображениях, кроме указанного, становятся неопределёнными; поэтому библиотека может использовать это.

Для символьных аргументов результат передаётся в качестве первого аргумента, за ним следует длина строки результата, затем два строковых аргумента, за которыми следуют два скрытых аргумента длины строк. При связывании с C скрытых аргументов нет, и передача по ссылке происходит либо только для одного символа, либо для описателя массива.

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