8.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 нет скрытых аргументов и передача по ссылке, и либо передаётся только один символ, либо описатель массива.

Предыдущий: _gfortran_caf_co_sum, Вверх: Документация ABI функций [Содержание][Индекс]