7.2.14 _gfortran_caf_send_by_ref — Пересылка данных из локального изображения в удалённое изображение с расширенными параметрами ссылок

Описание:

Вызывается для отправки скаляра, секции массива или всего массива из локального в удалённое изображение, идентифицируемое индексом image_index.

Синтаксис:

void _gfortran_caf_send_by_ref (caf_token_t token, int image_index, gfc_descriptor_t *src, caf_reference_t *refs, int dst_kind, int src_kind, bool may_require_tmp, bool dst_reallocatable, int *stat, int dst_type)

Аргументы:

`token`	intent(in) Непрозрачный указатель, идентифицирующий комассив.
`image_index`	intent(in) Идентификатор удалённого изображения; должно быть положительным числом.
`src`	intent(in) Описатель массива локального массива, который будет передан в удалённое изображение.
`refs`	intent(in) Ссылки на удалённый массив для хранения данных, заданных src. Гарантируется, что будет хотя бы один элемент.
`dst_kind`	intent(in) Тип данных результата
`src_kind`	intent(in) Тип данных исходного аргумента
`may_require_tmp`	intent(in) Переменная имеет значение `false` когда во время компиляции известно, что `dest` и `src` не могут перекрываться или перекрываются (полностью или частично) таким образом, что обход `src` и `dest` в порядке элементов (учитывая шаг) не приведёт к неверным результатам. В противном случае значение `true`.
`dst_reallocatable`	intent(in) Устанавливается, когда целевой параметр является разделяемым или указательным типом, и ссылки позволяют перераспределение, то есть ссылка представляет собой массив целиком или ссылку на компонент.
`stat`	intent(out) Если не `NULL`, то возвращает результат операции, то есть ноль при успехе и ненулевое значение при ошибке. Если `NULL`, и произошла ошибка, то выводится сообщение об ошибке, и программа завершается.
`dst_type`	intent(in) Определяет тип целевого параметра. Если целевой параметр не массив, то точный тип, например, компонента в производном типе, неизвестен, но предоставлен здесь.

ПРИМЕЧАНИЯ

Разрешается, чтобы image_index совпадал с текущим изображением; память отправки и получения может (частично) перекрываться в этом случае. Реализация должна позаботиться об обработке этого случая, например, с помощью memmove, который обрабатывает (частичное) перекрытие памяти. Если may_require_tmp имеет значение true, библиотека может дополнительно создать временную переменную, если дополнительные проверки не покажут, что это не требуется (например, если обращение назад возможно или оба массива непрерывны, и memmove обрабатывает проблемы с перекрытием).

Обратите внимание, что разрешено присваивание скаляра массиву. Кроме того, библиотека должна обрабатывать преобразование числовых типов и для строк, заполнение и разные типы символов.

Из-за более сложных возможных ссылок некоторые операции могут быть не поддерживаемыми определёнными библиотеками. Библиотека должна вывести точное сообщение об ошибке, почему операция запрещена.

© 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_005fsend_005fby_005fref.html