8.2.12 _gfortran_caf_get — Получение данных из удаленного изображения

Описание:

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

Синтаксис:

void _gfortran_caf_get (caf_token_t token, size_t offset, int image_index, gfc_descriptor_t *src, caf_vector_t *src_vector, gfc_descriptor_t *dest, int src_kind, int dst_kind, bool may_require_tmp, int *stat)

Аргументы:

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

ПРИМЕЧАНИЯ

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

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

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